home *** CD-ROM | disk | FTP | other *** search
/ Southern Beauties 2 / Southern Beauties - Volume 2.iso / viewer / vpic.doc < prev    next >
Text File  |  1995-10-30  |  100KB  |  1,794 lines
  1.                        VPIC ver 7.0 USERS MANUAL
  2.                A Picture File Viewing/Conversion Program
  3.              (C) Copyright 1990-1995, All Rights Reserved
  4.                    by Bob Montgomery  CIS 73357,3140
  5.  
  6.                                  INDEX
  7.     Topic
  8.     Introduction
  9.     General Features and Modes
  10.         Menu Mode
  11.         Single File Mode
  12.         Single File Mode
  13.         Slide Mode
  14.     SuperVGA Boards Supported
  15.     Filetypes Viewed and Converted
  16.     Menu Features
  17.         Mouse Support
  18.         Menu Layout
  19.     Commands while Viewing
  20.     VPIC Command Line Options
  21.     Examples of VPIC Command Line Options
  22.     Slideshows
  23.     Detailed Command List
  24.         Keyboard and Mouse Commands in Menu Mode
  25.         Keyboard and Mouse Commands while Viewing a Picture
  26.     Decoding Other File Formats
  27.     Added features
  28.     Known Problems
  29.     Support For Other SuperVGA Boards
  30.     Useful Techniques
  31.     How VPIC Operates
  32.         Decoding Directly to Screen Memory
  33.         Decoding to CPU Memory First
  34.     VPIC Terms and Conditions
  35.     Upgrades from Previous Programs and Updates
  36.     Orders from Me
  37.     Disclaimer
  38.     Special Versions
  39.     Graphic Oriented BBS's
  40.     Appendix A - Revision History                                 Appendix
  41.         History of VGIF . . . . . . . . . . . . . . . . . . . . . . . . .A1
  42.         History of VPIC . . . . . . . . . . . . . . . . . . . . . . . . .A3
  43.  
  44.                              MENU SCREEN
  45. 1024K Tseng ET-4000 256 Color    Max Colors=64K   Resize   Auto/Lock  Wait▒
  46. 320x200  640x350  640x400  640x480  80x600  1024x768
  47. FILE1.BMP    27K     FILE21.TIF  227K
  48. FILE2.CUT    43K
  49. FILE3.GIF    15K
  50. FILE4.LBM   427K
  51. FILE5.MAC    83K       4 Column, 20 Row Picture Menu
  52. FILE6.PCX    19K
  53. FILE7.PIC   228K
  54. FILE8.SCO   331K
  55. FILE9.TGA    99K
  56. .....
  57. Dialog Line                                                     Memory=498307
  58. SPACE=Tag/UnTag ENTER=Show ESC=Quit F1=Help F2=Slides F3=Info F4=EGA/VGA <-  ->
  59. F5/F6=-/+Res F7=Lock/Auto/Norm F8=Wait F9=Path AltF9=DIRS F10=ShowPath PgUp PgDn
  60.  
  61.     INTRODUCTION - The original program was called VGIF, reflecting its
  62.     ability to view only GIF files. When the program evolved to include
  63.     other paint file formats, its name was changed to VPIC. See the revision
  64.     history in Appendix A for latest additions and bug fixes. Look at the
  65.     section titled How VPIC Operates for an explanation of the differences
  66.     between VPIC and other viewers, and the advantages and disadvantages of
  67.     both types.
  68.  
  69.     The picture on the index page shows the screen you get if you just enter
  70.     VPIC in a directory that has viewable files. The top row tells what
  71.     SuperVGA card and how much memory VPIC thinks you have (you should
  72.     configure VPIC if this is not correct), the filespec VPIC is using (ie,
  73.     *.pcx), and is also where the Lock/Auto/Norm and Wait indicators appear
  74.     (shown in italics). The second row is the the resolution line, with the
  75.     current resolution hilited; you can chage resolution with F5/F6 or by
  76.     left clicking with the mouse. The next 20 lines are the alphabetical
  77.     listing of the viewable files; you can use the cursor keys and Enter or
  78.     the mouse to select one for viewing. Line 23 is the Dialog Line where
  79.     info and prompts appear; at the end of this line is the amount of free
  80.     memory that VPIC can use for slideshows. Line 24 and 25 list the more
  81.     common commands available from the menu; these can also be left clicked
  82.     with the mouse to activate them. Pressing F1 gives a help screen of
  83.     additional commands, and these can also be left clicked with the mouse
  84.     to activate them. There is much more to VPIC, but this quick overview
  85.     will give you the flavor of the program.
  86.  
  87.  
  88.     GENERAL FEATURES - VPIC is a very easy to use but powerful file viewer
  89.     and converter. It shows pictures in EGA, MCGA, VGA or SuperVGA video
  90.     modes on most of the popular display adapter cards, and uses a plain
  91.     text configuration file to tell VPIC which VGA chip your display card
  92.     uses and what video modes it can do. It has a single file, slideshow,
  93.     and menu mode of operation, and will show pictures in many of the
  94.     popular file formats. When a picture is on the screen, except in slide
  95.     modes, VPIC can manipulate the picture, or convert the picture to other
  96.     file formats. All this in a fast, easy to use program that puts you in
  97.     total control, and is rated by users as the top in it's class. It
  98.     supports 32K and 16.5M color modes using hi color DAC's for viewing 15
  99.     thru 32 bit files in BMP, JPG, PCX, TGA, and TIF formats, and does color
  100.     reduction (to 16 or 256 colors) with dithering for these file types if
  101.     you don't have a hi-color DAC.
  102.  
  103.     MENU MODE - This is the default mode when you just enter vpic from the
  104.     DOS command line. It lists all viewable files in a 4 column menu with
  105.     easy to use controls to allow you to show pictures the way you want to
  106.     see them, including a slide mode. See Menu Features.
  107.  
  108.     SINGLE FILE MODE - This mode has advanced features which make it
  109.     attractive for application programs which don't have the ability to
  110.     display hi-res graphics, such as data bases. You can shell to VPIC with
  111.     a filename and the /r option to display a picture and return immediately
  112.     to your application, without waiting for user input or displaying the
  113.     shareware message. If you want user input,  call a batch file containing
  114.         'vpic /r %1' and
  115.         'wait 100'.
  116.  
  117.     SLIDE MODE - This mode uses a plain text command file listing the
  118.     pictures you want to see in the order you want to see them, with mode
  119.     and delay specs if desired. This is particularly useful to showcase your
  120.     product line at trade shows, or to put on a self running demo. See
  121.     Slideshows. VPIC will now make a slide command file for you in the menu.
  122.     Just tag the files in the order you want to see them, and then press
  123.     Alt S. The slidefile can be edited to modify the slideshow.
  124.  
  125.     IMPORTANT: VPIC requires DOS 2.0 or up to run from the current
  126.     directory, or DOS 3.0 up to run from anywhere. Unless your video card
  127.     supports VESA correctly, you must configure VPIC for your graphics board
  128.     using CVPIC or CONFIG; VPIC comes configured for a Tseng ET-4000 SuperVGA
  129.     board with 1M memory. The WHICHVGA program will try to identify your VGA
  130.     chip and the amount of display memory you have, and will detect if your
  131.     board supports VESA and the modes it returns. See CONFIG.DOC.
  132.  
  133.     The Graphics Interchange Format (GIF) is a Service Mark owned by
  134.         Compuserve.
  135.     For further information, please contact:
  136.         Compuserve Incorporated, Graphics Technology Department,
  137.         5000 Arlington Center Boulevard, Columbus, Ohio 43220, USA
  138.  
  139.  
  140.     SUPERVGA BOARDS SUPPORTED  - Presently, VPIC has SuperVGA support for
  141.     the following SuperVGA chips (see CONFIG.DOC for details):
  142.     *   Ahead (A & B chip)
  143.     *   ATI New, old, Ultra, and Mach boards.
  144.     *   Chips & Technology
  145.     *   Cirrus GLD54xx boards (thru VESA)
  146.     *   Everex
  147.     *   Genoa
  148.     *   Headland/Video7 - Newer/older Video 7 cards.
  149.     *   NCR - used in newer Boca boards.
  150.     *   Oak
  151.     *   Paradise/Western Digital - Newer/older Paradise cards.
  152.     *   Primus - Used on Galaxy SVGA boards.
  153.     *   QVision - Compaq's video board
  154.     *   Realtek - used in Realtek board.
  155.     *   S3 GUI Accelerator - Doesn't use VESA info info is wrong.
  156.     *   Trident (8800BS/CS, 8900, and 94xx)
  157.     *   Tseng(ET-3000 and ET-4000)
  158.     *   Zymos - Used in HiRes VGA boards.
  159.     *   All boards that support VESA 1.1 and later correctly. If the info
  160.         returned by the board is incorrect, a generic VESA config file is
  161.         supplied, and you can configure with this and do 'vpic /v' to make
  162.         VPIC ignore the incorrect VESA info the board returns. This VESA
  163.         config file contains all standard VESA modes, and you can add/remove
  164.         semicolons to make it conform to your display board capabilities. It
  165.         works for most VESA boards, but may have to be 'tuned' for some boards
  166.         if they don't use standard bytes/line, etc.
  167.  
  168.     if you run the WHICHVGA program, it will try to identify your SuperVGA
  169.     board, and detect VESA if present. It works on about 95% of the SVGA cards.
  170.     You will then be asked if you want to configure, and if the info VPIC
  171.     found looks correct, press Y and you're done. If VPIC doesn't work correctly
  172.     use the CONFIG program to select other configurations to test. If your
  173.     display board implements the VESA standard (thru BIOS or a TSR) correctly,
  174.     this will be auto-detected and used regardless of the configuration; the
  175.     only drawback to VESA is you can't scroll down quite as far. The /v command
  176.     line option makes VPIC ignore the VESA info your display card returns, and
  177.     use the configuration info. See CONFIG.DOC, README.1ST, and PROBLEMS for
  178.     more info on configuration.
  179.  
  180.     FILETYPES VIEWED AND CONVERTED - VPIC will view and convert to the
  181.     following file formats [convert command while viewing in brackets]:
  182.  
  183.         1. Binary Image Files (BIF) from B&W image capture boards. Display
  184.            only.
  185.         2. Windows/OS2 1-24 bit BMP files, compressed or normal. [W]
  186.         3. Dr. Halo CUT files (with PAL if present). Not Dr. Halo PIC files,
  187.            which are display adapter specific. [C]
  188.         4. GIF87a and GIF89a files; saves to GIF87a format only since GIF89a
  189.            stuff is mainly animation and text handling enhancements.  [G=
  190.            normal], [I=interlaced], [M=mirrored], [U=upside down], [<=
  191.            rotated CCW 90 deg], [>=rotated CW 90 deg].
  192.         5. Deluxe Paint LBM (or IFF) files, regular and enhanced. [D]
  193.         6. Amatuer Radio Slow Scan TV HRZ files (display only).
  194.         7. Joint Photographics Experts Group JPG gray & 24 bit files. [J]
  195.         8. MacIntosh MAC files. Display only.
  196.         9. Pictor/PC Paint and Viewpoint PIC files. [P].
  197.        10. Zsoft 1-24 bit PCX files. [Z]
  198.        11. ColorRIX/EGA Paint SCx files, uncompressed only. RIX wont tell
  199.            anyone his compression algorithm, so compressed files can't be
  200.            done. Use ColoRIX's RIXLATE to uncompress SCx files that are
  201.            compressed. [R]
  202.        12. Targa 8-32 bit TGA files, compressed or uncompressed. [T]
  203.            Also uncompresses Targa files that are compressed (e option while
  204.            viewing).
  205.        13. Aldus 1-24 bit TIF files, all types except multi plane and FAX. [S]
  206.  
  207.     MENU FEATURES:
  208.     *   Handles up to 10,000 files using mouse or keyboard.
  209.     *   Gives 4 column menu of files with extensions VPIC recognizes.
  210.     *   Arrow keys, PgUp/PgDn move thru menu.
  211.     *   Starting letter (or number) of filename jumps to files starting with
  212.         that character.
  213.     *   Shows file at cursor with ENTER or left mouse button.
  214.     *   Mark/unmark files for viewing with SPACEBAR or right mouse button.
  215.     *   Shows marked files singly (ENTER or left mouse button) or like a
  216.         slide show (F2) in the order marked.
  217.     *   [F1] gives help.
  218.     *   [F2] shows marked files like a slideshow.
  219.     *   [F3] gives file size, colors, and other info.
  220.     *   [Alt F3] gives current VPIC settings and video modes VPIC thinks you
  221.         have. Enter or Esc returns to menu. Changes made with keys or mouse.
  222.     *   [F4] toggles between 16 (EGA) and 256 (VGA) color modes.
  223.     *   [F5/F6] decrease/increase default resolution.
  224.     *   [Alt F5/F6] decrease/increase locked hi color mode (hi-color cards only).
  225.     *   [Alt F6] shows all 16, 256, and hi-color modes VPIC thinks you have.
  226.     *   [F7] Locks current resolution, or selects auto resolution mode.
  227.     *   [Alt F7] locks a hi-color mode if your display card supports these.
  228.     *   [F8] Makes multi-image GIF's pause for a keypress between images.
  229.     *   [F9] prompts for new path. The current path can be edited.
  230.     *   [Alt F9] gives a directory tree in the menu window.
  231.     *   Alt_C copies tagged files (or file at cursor) to a new path.
  232.     *   Alt_D prompts for new slide delay for slideshow (F2).
  233.     *   Alt_G toggles auto-resizing on/off for pictures that don't fit screen.
  234.     *   Alt_I toggles palette minimization on/off.
  235.     *   Alt_K toggles slide animation (for weathermap type shows) on/off.
  236.     *   Alt_L prompts for new fixed margins.  Entering 'a' makes that axis
  237.         auto centering (default).
  238.     *   Alt_M moves tagged files (or file at cursor) to a new path.
  239.     *   Alt_Q toggles palette optimization (quality) on/off.
  240.     *   Alt_S makes a slidefile of the current marked files.
  241.     *   Alt_T (tag) marks all files from cursor on.
  242.     *   Alt_U (untag) unmarks all files.
  243.     *   Alt_V toggles dithering for color reduction on/off.
  244.     *   Alt_X deletes tagged files (or file at cursor). Prompts for each file;
  245.         Y deletes the file, N doesn't, ESC aborts the delete operation.
  246.     *   Alt_Z toggles the name display while decoding on/off. Default is on
  247.         unless /z passed on DOS command line.
  248.     *   Menu text color setable in configuration file.
  249.  
  250.     MOUSE SUPPORT - All the above functions are now controllable by the
  251.     mouse. Click on the resolution bar, bottom 2 lines of quick help, or
  252.     files. For the menu screen, the left button is the same as enter, and
  253.     the right button is the same as the spacebar. While decoding, the right
  254.     button aborts; while viewing, the left button returns to the menu. Most
  255.     of the Alt functions can be done by clicking on the quick help at the
  256.     bottom of the scree or from the help/menu (F1). Left clicking on the board
  257.     name toggles 16/256 colors, and on the Max Colors left clicking decreases
  258.     the max colors (0=auto), and right clicking increases max colors. Left
  259.     clicking on the dither symbol ░ toggles dithering on/off for color
  260.     reduction. The Alt F9 (directory tree) can be done by right clicking F9 or
  261.     left clicking Alt F9.
  262.  
  263.     MENU LAYOUT - Menu lines are as follows:
  264.     Line   Contents
  265.     1      Gives the board type along with the number of colors (16 or 256).
  266.            Toggle values also appear on this line (Lock/Auto, Wait, Resize,
  267.            Dither).
  268.     2      Gives the resolutions available with the default resolution
  269.            highlighted.
  270.     3 - 22 Four column menu of files with extensions VPIC recognizes.
  271.     23     Prompt and message line. Free memory displayed at far right.
  272.     24, 25 Quick help on commands and mouse menu.
  273.  
  274.     ENVIRONMENT VARIABLES - VPIC understands two environment variables, VPICSAVE
  275.     and VPICDISK.
  276.     VPICSAVE - If the 'VPICSAVE=path' exists in the environment (added with 'set
  277.         vpicsave=path' and removed with 'set vpicsave='), VPIC saves all files
  278.         to 'path' if it is writeable. This is useful when viewing CDROM images.
  279.     VPICDISK - If 'VPICDISK=abce' exists in the environment, VPIC uses only the
  280.         drives specified (in this case A, B, C, and E) for Alt F9 (change path).
  281.         Useful to make VPIC ignore password protected drives or additional
  282.         floppies on startup; otherwise, VPIC tries to read the current directory
  283.         on each drive to see if it is there, which can delay startup.
  284.  
  285.     COMMANDS WHILE VIEWING - The following commands (shown in brackets) are
  286.     available any time the picture is on the screen.
  287.     *    Shows filename while decoding, and [ESC] aborts decoding. Menu Alt_Z
  288.         or command line /z overrides toggels showing filename on/off.
  289.     *   / or ? or clicking the right mouse button gives a help/menu overlay.
  290.         The desired command can be clicked with the left mouse button or the
  291.         key can be pressed to activate the command (except for F1-F10).
  292.     *   Tab resizes the picture to fit the screen, keeping current aspect ratio.
  293.     *   [A] animates a picture by rotating the palette; very pleasing for
  294.         fractals. SPACEBAR pauses the animation, ENTER stops it for further
  295.         commands such as conversions, and ESC returns to the menu. Up/Dn
  296.         arrows and PgUp/PgDn increase/decrease the animation rate.
  297.     *   [B] converts a 256 color picture to 64 gray shades. 256 color modes
  298.         only. Alt_F10 doesn't undo this conversion.
  299.     *   [E] expands a compressed Targa to disk for use by other programs.
  300.     *   [F] prompts for another filename and x,y margins; gives picture in
  301.         picture. Works best when VPIC invoked with /m, /x, and /y command
  302.         line options, or with Lock (F7) and Alt_L to set the margins from
  303.         the menu.
  304.     *    [C, D, G, I, J, M, P, R, S, T, U, W, Z, <, >] are file conversion
  305.         commands; see 'FILETYPES VIEWED' above. The picture is converted in
  306.         the number of colors you are viewing it in, thus allowing 256 <-> 16
  307.         color conversions. For BMP, PCX, TGA, and TIF files VPIC will ask if
  308.         you want a 24 bit file.
  309.     *   [Alt F] momentarily displays filename in case you forgot.
  310.     *   [Alt X] prompts if you want to delete this file; Y deletes.
  311.     *   For marked (tagged) file viewing:
  312.            [ENTER] or  shows next file in a continuous loop.
  313.            [Alt ENTER] or  shows previous file in a continuous loop.
  314.            [ESC] or Alt Q breaks the loop and returns to the menu.
  315.     *   [F1-F10] are adjustments for red, green, blue, contrast, and
  316.         brightness which decrease/increase in pairs; ie F1 decreases red, F2
  317.         increases red. [Alt F10] restores the original palette (except after
  318.         a [B] command).
  319.     *   If the picture is larger than the screen the Up/Dn arrows and
  320.         PgUp/PgDn scroll the picture vertically on the screen. This only
  321.         works if you have enough video memory and your display card will
  322.         write to video memory not being displayed (Video 7 won't). VPIC
  323.         doesn't scroll sideways; see 'How VPIC Operates'.
  324.  
  325.     VPIC COMMAND LINE OPTIONS - The command line format for running VPIC is:
  326.       vpic [[path]filespec] [/a /b /d[t/p] /e /f /g /h /i /k /l /mN /M:AxBxC
  327.         /o /p /q /r /v /w /xN /yN /z /? /@filename /single /snap]
  328.     where:
  329.     *   The default path is the current drive and directory, and the default
  330.         extensions are BIF, BMP, CUT, GIF, IFF, JPG, LBM, MAC, PIC, PCX, RLE,
  331.         SCx, TIF, and TGA. Only Pictor & Viewpoint PIC files are supported.
  332.     *   The /a option starts VPIC in Auto resolution select mode.
  333.     *   The /b option causes VPIC to beep after displaying a file except in
  334.         slide mode or with /r.
  335.     *   The /d option saves files to the current directory; the default is the
  336.         same directory you're viewing. Good for saving CDROM pics. /dp saves
  337.         to the picture directory, and /dt save to the startup directory.
  338.     *   The /e option starts VPIC in 16 color (EGA) mode.
  339.     *   The /g option turn auto-resizing on.
  340.     *   The /h option allows the viewing of hidden files; great for R or X
  341.         rated files which you don't want to appear in the menu normally.
  342.     *   The /i option turns on palette minimization to eliminate redundant
  343.         palette colors.
  344.     *   The /k option turns on slide animation for showing a collection of
  345.         pictures like the weathermaps on TV.
  346.     *   The /l option tells VPIC not to set the video mode. This is used to
  347.         add a picture to a picture already on screen. Works best with /r /m
  348.         /x /y, and from a batch file with 1st line '@echo off'.
  349.     *   The /mN or /m:aaaXbbbXccc locks the video resolution. N is determined
  350.         from the menu or the configuration file. aaa & bbb are the X & Y
  351.         resolutions, and ccc is the number of colors (16, 256, 32K, 64K, 16M).
  352.     *   The /o option tells VPIC not to check for EGA/VGA on startup and
  353.         just use the configuration file info.
  354.     *   The /p option stops VPIC from swapping GIF background color and
  355.         color 0. Good for saving to PCX files for PC Paintbrush.
  356.     *   The /q option turns on quality, which does palette optimization for
  357.         hi-color reduction, but is slower.
  358.     *   The /r option immediately returns control to a calling program after
  359.         displaying the picture. Calling program must reset text mode (mode
  360.         co80) if required. VPIC returns an integer, and if negative means:
  361.            -1  Can't find the file specified.
  362.            -2  Not a valid picture file for the extension.
  363.            -3  File read or write error.
  364.            -4  Disk is full.
  365.            -5  Not enough memory for operation.
  366.            -6  An image in a GIF file is larger than the picture.
  367.            -7  Operation not supported.
  368.     *   The /snap option makes pictures snap onto the screen instead of
  369.         painting while decoding. Uses EMS/XMS memory.
  370.     *   The /t option tags all files in a directory and displays the first.
  371.         Then Enter or  shows next, and AltEnter or  shows previous. Esc or
  372.         Alt Q quits to DOS.
  373.     *   The /v option disables VESA detection and uses the config file info.
  374.     *   The /w option wait for a keypress after each image in a multi-image
  375.         GIF file. Only works for multi-image GIFs.
  376.     *   The /xN option gives a N pixel left margin for pictures smaller than
  377.         the screen horizontally; default is centered.
  378.     *   The /yN option gives a N pixel top margin for pictures smaller than
  379.         the screen vertically; default is centered.
  380.     *   The /z option inhibits printing the filename of each file when
  381.         showing.
  382.     *   The /? option gives a multipage help screen of command line options.
  383.     *   The /@filename option uses the commands in file filename to do a
  384.         slideshow. The default filename extension is SLD. /single allows
  385.         manual control with the / keys, and Esc or Alt Q quits to DOS.
  386.     *   If filespec is a filename, the single file will be shown (the
  387.         default extension is GIF for picture files).
  388.     *   If path\filespec is a directory, a menu of all viewable files in
  389.         that directory will appear. Otherwise all files meeting the filespec
  390.         will appear. For example, [vpic d:\pics\*.pcx] would give a menu of
  391.         all PCX files in the PICS directory of drive D, while [vpic d:\pics]
  392.         would give a menu of all viewable files in the PICS directory of D:.
  393.     Options and filespec may be entered in any order. The /r and /l options
  394.     only work in single file mode; all others work in menu or single file
  395.     mode.
  396.  
  397.     EXAMPLES OF VPIC COMMAND LINE OPTIONS
  398.  
  399.     *   vpic [path\]filename[.ext] shows the single file specified. The
  400.         default path is the current directory, and the default extension is
  401.         GIF.
  402.     *   vpic [path\][filespec] will give a menu of all files in the
  403.         specified path meeting filespec (may contain wildcards). The default
  404.         path is the current directory, and the default filespec is any of
  405.         the viewable files; just entering VPIC will give a menu of all
  406.         viewable files in the current directory. If Path contains . or .., a
  407.         filespec must be given (may contain wildcards). Thus ..\*.* would
  408.         give a menu of all viewable files in the parent of the current
  409.         directory.
  410.     *    vpic /a starts VPIC in auto resolution mode.
  411.     *    vpic /b causes VPIC to beep after a file has been fully  decoded.
  412.         Lets you know when the viewing options are available. Doesn't beep
  413.         in slide mode or when using the /r option.
  414.     *    vpic /e starts VPIC in 16 color (EGA) mode; default is 256 color
  415.         modes.
  416.     *    vpic /h allows VPIC to find and display hidden files in the menu.
  417.         Great for those R or X rated files you don't want to be normally
  418.         accessible. This option doesn't appear on the help screen.
  419.     *   vpic /r filename[.ext] shows the filename picture and then returns
  420.         to DOS (or a calling application program) with the picture still on
  421.         the screen. It is not necessary to change the video mode between
  422.         viewing each file, but it is up to the calling program to reset text
  423.         mode (mode 3) after all viewing is done. The /a, /e, /l, /m, /x, /y
  424.         switches are valid with /r.
  425.     *   vpic /v gives a menu of the files in the current directory, but does
  426.         not look for VESA info from the display card. This is useful if the
  427.         VESA info is incorrect or doesn't support all the modes the card can
  428.         do.
  429.     *   vpic /? gives a help screen for modes and command line options.
  430.  
  431.     Example:   vpic /m:640x480x256 /x0 /y0 /r file1 displays file1 in
  432.                640x480x256 color mode in the upper left corner. Then, vpic /r
  433.                /l file2 /x320 /y200 displays file2 starting at column 320 and
  434.                row 200 leaving file 1 on the screen.
  435.  
  436.     SLIDESHOWS
  437.  
  438.     vpic /@[path\]slidefile[.ext] [/single] will do a slide show from
  439.     commands in a plain ASCII text slidefile. The default path is the current
  440.     directory, and the default slidefile extension is SLD. The path applies
  441.     to both the slide file and all files for viewing, but VPIC allows you to
  442.     set a different path in the command file for the pictures. The commands
  443.     are placed on separate lines, and consist of either:
  444.     a.  A filename (GIF extension assumed) followed by (optional):
  445.         1. Display mode (number) and/or
  446.         2. Animate command (a) followed by optional number of vertical
  447.            retraces between animation steps.
  448.     b.  A delay (viewing time) spec of the form 'd n' (space required) where
  449.         n is the desired viewing time in seconds.
  450.     c.  A path for all the picture files in the form 'p path' (space req'd).
  451.     d.  The statement QUIT to end the slideshow after 1 pass. QUIT may be
  452.         upper or lower case.
  453.  
  454.     The maximum number of files is 100. To make a slideshow with more than
  455.     100 files, use a looping batch file and multiple slide files with the
  456.     QUIT statement at the end of each slide file. The default animation value
  457.     is 8 (if no number follows the 'a'). The mode is explained below.
  458.  
  459.     To pause a slideshow press [SPACEBAR]; to end it press [ESC].
  460.  
  461.     The default viewing time is 5 seconds if no delay spec is given. A delay
  462.     spec applies to all files following in the slide file until changed. The
  463.     first slide is not delayed the first time it is shown. The default
  464.     viewing mode is automatic (whatever fits). The /single allows you to
  465.     manually go forward/backward with the / keys.
  466.  
  467.     VPIC understands comments preceded by a semicolon, blank or comment lines,
  468.     and extra spaces. For example, the following slide file contents are
  469.     understood by VPIC, but not recommended:
  470.  
  471.     d 20       ;Delay for file1.gif & file2.pcx is 20 seconds.
  472.     file1 1    ;First file in slideshow. File1.gif using mode 1.
  473.         file2.pcx ;This is a Zsoft filename with leading spaces.
  474.         ;This is a comment line with leading spaces, next is a blank line.
  475.  
  476.     p c:\pics  ;The directory for the picture files is c:\pics
  477.     d 10       ;File3 is delayed 10 seconds.
  478.     file3 a30  ;Show file 3, animate at 1 shift every 30 vertical retraces.
  479.         d   15 ;15 second delay file4.gif. Has leading & separator spaces.
  480.     file4      ;Show file4.gif for 15 seconds, then do file1.gif.
  481.  
  482.     The mode requires a little further explanation. In the above slide file,
  483.     it says to use mode 1 with file1. Modes 1 thru 10 are the VGA (256
  484.     color) modes, and modes 11 thru 20 are EGA (16 color) modes. Most
  485.     display boards only have a few of each type. The Orchid Designer has 4
  486.     VGA modes and 4 EGA modes which appear in the file menu.
  487.         The VGA modes are                 ║ The EGA modes are
  488.         1. 320x200x256   2. 640x350x256   ║ 11. 640x350x16   12. 640x480x16
  489.         3. 640x480x256   4. 800x600x256   ║ 13. 800x600x16   14. 1024x768x16
  490.     Thus, the slide file says to show file1 in the 320x200x256 mode, and
  491.     show all the others in the default modes (whatever fits).
  492.  
  493.     VPIC will now create a slidefile for you. In the menu you mark the files
  494.     you want in your slideshow, set the delay (using Alt_D) and then press
  495.     Alt_S. VPIC will prompt you for a filename, and will automatically tack
  496.     on the extension '.SLD'. It saves the current delay, the current path,
  497.     and the files in the order you marked them.
  498.  
  499.     DETAILED COMMAND LIST - The following gives details & peculiarities of
  500.     the various commands.
  501.  
  502.     Keyboard and Mouse Menu Mode Commands.
  503.     *   The , , ,  arrow keys move the cursor around the menu of files.
  504.         [PgDn/PgUp] goto next/previous page. Pressing a key goes to next file
  505.         starting with this character. The PgUp/PgDn area in the lower right
  506.         corner allow the mouse to change pages.
  507.     *   Pressing the [SPACEBAR or the right mouse button] marks a file for
  508.         viewing or slides, and [SPACEBAR] moves to the next file; it will
  509.         also unmark a previously marked file.
  510.     *   Pressing [ENTER or the left mouse button] will display the marked
  511.         files in the order they were marked. If no files were marked, pressing
  512.         enter or the left mouse button displays the file at the cursor.
  513.     *   Pressing [F1] will bring up the help/menu screen; Enter or Esc will
  514.         return to the menu. Clicking the left mouse button on a command
  515.         activates it, and clicking the right mouse button returns to the menu.
  516.     *   Pressing [F2] will do a slide show of marked files until [ESC] is
  517.         pressed.
  518.     *   Pressing [F3] will display information about the file at the cursor.
  519.         (picture size, colors, and filetype) on the prompt/message line.
  520.     *   Pressing [Alt F3] displays the current VPIC settings on a seperate
  521.         screen. Toggles, paths, and video modes are displayed, and these
  522.         settings can be changed with the mouse or keyboard. With the mouse,
  523.         clicking on toggles or video modes changes them, and clicking on a path
  524.         puts VPIC in edit mode, where:
  525.         *   Insert toggles type modes; a large cursor indicates insert mode, and
  526.             an underline cursor is overtype mode.
  527.         *   The left/right cursor keys move the cursor.
  528.         *   Backspace and delete do their normal function.
  529.         *   If the first key pressed is alphanumeric, the path is erased and
  530.             you type in the new path.
  531.         *   Enter terminates the entry, and Esc aborts it.
  532.         From the keyboard Tab advances fields, and any key (except Enter or Esc)
  533.         toggles entries. The video modes cannot be set from the keyboard on the
  534.         settings screen, but can be set by F5/F6 from the menu.
  535.     *   Pressing [F4] will toggle between 256 (VGA) and 16 color (EGA)
  536.         modes. Left clicking the mouse on the board name also toggles
  537.         between VGA/EGA.
  538.     *   Pressing [F5/F6] will decrease/increase the default resolution for
  539.         file viewing. In VGA, the default resolution for 320x200 pictures is
  540.         320x200 unless 'lock' [F7] is invoked. Left clicking the mouse on a
  541.         resolution sets that resolution as the default.
  542.     *   Pressing [Alt F5/F6] decreases/increases the hi color lock mode; see
  543.         Alt F7 below.
  544.     *   Pressing [F7] goes to LOCK, which forces the default resolution
  545.         (above) no matter what the file size. Pressing F7 again goes to
  546.         AUTO, which automatically selects a resolution which will display
  547.         the whole picture. Pressing F7 again goes back to the normal default
  548.         mode. You can left click the mouse on Lock, Auto, Norm, on line 25
  549.         of the menu to set that mode.
  550.     *   Pressing [Alt F7] allows you to lock a hi-color mode (if your video card
  551.         does hi-color). 0 is auto select, 1 is 256 colors, 2 is 32K colors, 3 is
  552.         64K colors, and 4 is 24 bit (16.7M colors).
  553.     *   Pressing [F8] toggles the wait mode, where VPIC waits for a keypress
  554.         between multiple images in a GIF file.
  555.     *   [F9] prompts for a new path\filespec. The current path can be edited as
  556.         when Alt F3 is pressed. When Enter is pressed, VPIC displays a menu of
  557.         the files in the new path meeting the filespec.
  558.     *   [Alt F9] gives a directory tree of the current drive in the menu
  559.         window. The DOS drives are listed on the 2nd line, and may be selected
  560.         with the mouse or by pressing the drive letter key. The environment
  561.         variable VPICDISK can be used to specify the drives that VPIC should
  562.         look at in the directory tree; it is just a list of the drives with or
  563.         without spaces. Thus set vpicdisk=abce would allow VPIC to look at
  564.         drives A, B, C, and E. The first time a drive is selected, VPIC scans
  565.         the drive for all subdirectories, and saves this info in a file called
  566.         $$DRIVEx (where x is the drive letter) in the same directory where
  567.         VPIC is located. Subsequent times, the drive data is retrieved from
  568.         this file, and the drive is not scanned. If you added or removed
  569.         directories, you should probably rescan the drive by pressing Alt_S or
  570.         clicking the mouse where it says Alt S on the directory tree screen.
  571.         The cursor keys work the same as in the normal file window, and a
  572.         directory is selected by pressing Enter or clicking on it with the
  573.         left mouse button. The directory tree is folded into 4 columns, and
  574.         the indent level of a directory is shown by the lines preceding the
  575.         name. The PgUp/PgDn and <- -> move the display by clicking these
  576.         locations with the mouse.
  577.     *   [Alt C] copies tagged files (or the file at the cursor if none are
  578.         marked) to specified path.
  579.     *   [Alt D] prompts for a new slide [F2] delay time in seconds.
  580.     *   [Alt G] toggles auto resizing to fit the screen on/off.
  581.     *   [Alt I] toggles palette minimization (eliminate duplicate colors).
  582.     *   [Alt K] toggles slide animation (TV weathermap like display).
  583.     *   [Alt L] prompts for new fixed margins (a is auto centering).
  584.     *   [Alt M] moves tagged files (or the file at the cursor if none are
  585.         marked) to specified path.
  586.     *   [Alt R] prompts for a new filename to rename the file at the cursor.
  587.     *   [Alt S] creates a slidefile of the marked files; see Slideshows.
  588.     *   [Alt T] tags (marks) all files in the menu from the cursor on.
  589.     *   [Alt U] untags (unmarks) all files in the menu.
  590.     *   [Alt X] deletes tagged files (or the file at the cirsor if none are
  591.         tagged). VPIC confirms before each delete. [Y] will delete it, [N] or
  592.         ESC doesn't, and all other keys are ignored.
  593.     *   [Alt Z] toggles filename display on/off.
  594.     *   Pressing [ESC] ends the program and returns to DOS.
  595.     *   Pressing [Ctrl-Break] or [Ctrl-C] will get you directly to the
  596.         opening menu from anywhere.
  597.  
  598.     All other keys are ignored. If errors are encountered, an error message
  599.     appears on the third line from the bottom, and disappears when the
  600.     cursor is moved. The amount of far memory available is also printed on
  601.     the same line. The menu title is the search spec.
  602.  
  603.  
  604.     Keyboard and Mouse Commands while Viewing a Picture (except in slide mode)
  605.  
  606.     *   The up/down arrow keys will scroll the picture by one line if it is
  607.         longer than the screen, provided you have sufficient display memory.
  608.         The [PgUp] and [PgDn] keys will scroll by 10 lines. The Video 7
  609.         extended VGA boards do not support writing to non-displayed memory
  610.         or scrolling pics larger than the screen, so this function is
  611.         disabled for these boards. Straight VGA boards can't scroll in
  612.         320x200x256 mode because the picture takes up all of display memory.
  613.         VPIC will not scroll sideways; see 'How VPIC Operates'.
  614.     *   If the picture size is <= 1/2 the screen width, pressing [2] will
  615.         give a double size image (which may be scrollable) and pressing [1]
  616.         will give the normal size again. For VGA, the picture will be
  617.         changed only in the horizontal direction; this will unsquash some
  618.         320x400 pics so the aspect ratio is correct.
  619.     *   Pressing [+] will increase the resolution (320x200 to 640x480, etc).
  620.     *   Pressing [-] will decrease the resolution; useful if 800x600 rolls.
  621.     *   Pressing [/] or [?] or clicking the right mouse button gives a
  622.         help/menu screen of commands available while viewing.  Left clicking
  623.         the mouse on the command or pressing the command key activates the
  624.         command (except for F1-F10). Right clicking the mouse or pressing
  625.         Enter or Esc removes the help/menu overlay.
  626.     *   [Alt_F] displays the current filename momentarily.
  627.     *   Pressing [ENTER] will return to the menu or DOS, or show next file
  628.         for marked menu mode.
  629.     *   Pressing [Alt ENTER] will show the previous marked file (if any are
  630.         marked).
  631.     *   Pressing [ESC] will end the display and return to the menu.
  632.     *   Pressing [Alt-X] will prompt you to delete the current file. If you
  633.         answer [y] it will be deleted, [n] or ESC it won't, and all other
  634.         keys are ignored.
  635.     *   Pressing Spacebar, while viewing tagged files only, marks the file
  636.         for further action back in the menu. There, Alt U untags the files
  637.         you just viewed, and tags the ones for which you pressed Spacebar.
  638.         Thes may be viewed, copied, moved, or deleted.
  639.  
  640.     NOTE: The file conversion options now work when viewing in hi-color modes
  641.     for BMP, PCX, TGA, and TIF files. File conversions are done in whatever
  642.     mode you are viewing with (EGA, VGA, or hi color), and save to the same
  643.     filename with the appropriate extension. All the conversion commands
  644.     check if the default filename is present, and prompt for a new name if it
  645.     is. They create a file on the current drive and directory with the same
  646.     dimensions as the file being viewed. If you screw up at the new filename
  647.     prompt, hit [Ctrl-C] to escape immediately to DOS; this will usually
  648.     preserve a file you don't want to write over. The safest bet is to view
  649.     files in another directory using the -d command line option, since the
  650.     new file is saved to the default directory, which is the drive and
  651.     directory you ran VPIC from. I put VPIC in my UTIL directory, and have my
  652.     PATH set to include UTIL, so I can run VPIC from any drive or directory.
  653.  
  654.     *   Pressing [A] will 'animate' a picture by rotating the palette
  655.         periodicly. This is especially effective on fractals, where large
  656.         areas tend to be the same color. Pressing [SPACEBAR] will pause the
  657.         palette rotation, and pressing [ENTER] will stop it and return to
  658.         the command mode. Thus, by waiting for an especially nice pattern
  659.         and then pressing [ENTER], the pattern can be written to a file
  660.         using the file save commands. Pressing [ESC] will return to the
  661.         menu. The rate of palette rotation can be increased/decreased with
  662.         the up/down arrows (slow) or PgUp/PgDn (fast).
  663.     *   Pressing [B] will convert a color VGA picture to a 64 shade gray
  664.         picture. The resulting image can be saved with the gray palette.
  665.         Only works in VGA. The original palette cannot be restored with [Alt
  666.         F10] after [B], but you can always redisplay the picture to see it
  667.         in color again.
  668.     *   Pressing [C] will create a Dr. Halo CUT file with the same filename
  669.         and extension CUT. A palette file (.PAL) will also be created.
  670.     *   Pressing [D] will create a Deluxe Paint II (Electronic Arts) file.
  671.         VPIC will prompt for a normal or enhanced DP II file, and for
  672.         compressed or uncompressed.
  673.     *   Pressing [E] will expand a Run Length Encoded (RLE) compressed Targa
  674.         file. If the file is not a Targa or is already uncompressed, this
  675.         key does nothing. You have to supply a new filename.
  676.     *   Pressing [F] will prompt for a new filename to overlay on the
  677.         existing picture. It also prompts for x and y offsets (in pixels).
  678.         The colors may not be exactly correct since the new picture uses a
  679.         best match to the palette of the original picture, and some colors
  680.         may be missing. This feature is handy for building composite
  681.         pictures; ie, four 320x200 pics on a 640x400 screen with the screen
  682.         size 'locked' using F7 or /m on the command line. Specify where you
  683.         want to place the first picture on the command line when VPIC is
  684.         executed using the /x and/or the /y options, or use the Alt_L
  685.         command from the menu; the filename display is suppressed using the
  686.         /z option on the command line. Alternately, you can have an all
  687.         black picture as the first picture, then overlay the others onto it.
  688.         The composite picture can then be saved in any of the file formats
  689.         VPIC supports. You can also specify the /mN resolution mode from the
  690.         command line to lock the video mode to the desired composite size;
  691.         it can be changed once you are in the menu. Later pictures use the
  692.         first pictures palette (if all are 256 color), so it's a good idea
  693.         to pick the first picture with the widest range of palette colors;
  694.         this gives the best rendition of the other pictures. A good way to
  695.         invoke VPIC for this mode is `vpic /x0 /y0 /z /m3'.
  696.     *   Pressing [G, I, M, U, <, or >] will create a GIF file. [G] is for
  697.         non-interlaced, and [I] is for interlaced, [M] is for mirror image,
  698.         [U] is for upside down (inverted), [<] is rotate image 90 degrees
  699.         CCW, and [>] is rotate image 90 degrees CW.
  700.     *   Pressing [J] will create a JPEG JPG file.
  701.     *   Pressing [P] will create a PC Paint or Pictor PIC file.For EGA it
  702.         prompts for a PC Paint or Pictor file.
  703.     *   Pressing [R] will create a ColoRix SCx file, where x is a function of
  704.         the screen size. If in EGA, will prompt if you want an EGA Paint or
  705.         ColoRix file.
  706.     *   Pressing [S] will make a TIF file. Prompts for a 24 bit TIF.
  707.     *   Pressing [T] will make a Targa 16 or 24 file. VPIC defaults to Targa
  708.         16, and prompts for Targa 24.
  709.     *   Pressing [W] will create a Windows BMP file, and prompts for a
  710.         compressed or uncompressed file. Be aware that compressed BMPs are
  711.         sometimes larger than uncompressed.
  712.     *   Pressing [Z] will create a Zsoft PCX file. Prompts for a 24 bit PCX.
  713.     *   The following keys control the picture tone as follows:
  714.         [F1]   Decrease red content of picture.
  715.         [F2]   Increase red content of picture.
  716.         [F3]   Decrease green content of picture.
  717.         [F4]   Increase green content of picture.
  718.         [F5]   Decrease blue content of picture.
  719.         [F6]   Increase blue content of picture.
  720.         [F7]   Decrease contrast of picture (VGA only).
  721.         [F8]   Increase contrast of picture (VGA only).
  722.         [F9]   Decrease brightness of picture (VGA only).
  723.         [F10]  Increase brightness of picture (VGA only).
  724.         [Alt-F10]  Restore original palette after you thoroughly mess up the
  725.                colors. Doesn't work after a [B] grey shade conversion.
  726.         [V]    Reverses the current palette; interesting effect especially
  727.                for black & white images.
  728.     After a little experimenting, a 'washed out' 256 color picture can be
  729.     greatly improved by using [F1-F10], and you can always start over by
  730.     using [Alt-F10]. To retain a black background in a VGA picture, the
  731.     brightness should be decreased when the contrast is decreased. If you
  732.     have really improved the picture, you can then save it any of the
  733.     supported formats. VPIC will prompt you if the file exists in the default
  734.     directory, and you have the option of overwriting it or giving a new
  735.     filename. This works really well with images created on flatbed scanners,
  736.     which are sometimes 'washed out'.
  737.  
  738.     All other keys are ignored. Pressing [Ctrl-Break] or [Ctrl-C] will go
  739.     directly to the opening menu screen. This is useful to abort an
  740.     inadvertant command you may have given VPIC.
  741.  
  742.     DECODING OTHER FILE FORMATS
  743.  
  744.     Each picture is viewed in whatever mode you are presently using (VGA or
  745.     EGA) and at the resolution you have selected. If you choose to save to
  746.     another file format which differentiates between VGA and EGA modes, it
  747.     will be converted using the appropriate rules. This makes EGA <-> VGA
  748.     conversions possible, which is not supported by most paint programs.
  749.  
  750.     The decoding for other than GIF is not as fast as could be done, but the
  751.     added versatility more than compensates for this. For example, EGA PCX
  752.     files can be very quickly decoded to EGA, but are in the wrong format
  753.     for VGA, and considerable manipulation is required to produce a VGA
  754.     image. For all formats, the method of viewing is to decode to a buffer
  755.     for a single line at 1 byte/pixel, then copy this line to the display in
  756.     whatever mode you are using. This is a compromise for most file formats,
  757.     since they are geared to EGA or VGA, and display time suffers, but it
  758.     makes the code much simpler. Besides, the other formats are supported
  759.     mainly to allow easy conversion to GIF, which is the preferred format
  760.     for storage since it gives the smallest file size.
  761.  
  762.     The BMP 24 bit, JPG 24 bit, PCX 24 bit, TGA 16-32 bit, and TIF 24 bit
  763.     files are viewind in hi- color if you have it, and color reduced to 256
  764.     colors if you don't, so the color rendition is pretty good. The Pegagsus
  765.     Imaging Corp's SHOWTGA and Image Tools TGAPIC do a better job of color
  766.     reduction, but only work for TGA files. If you use SHOWTGA (which
  767.     converts to a Targa 256 color file), you can use VPIC to convert this to
  768.     GIF.
  769.  
  770.     ACKNOWLEDGEMENTS
  771.  
  772.     Thanks to Pegasus Imaging Corporation for the method of fast dithering If
  773.     you need any special purpose programs for displaying/compressing advanced
  774.     file formats (JPG, Fractal, etc) call or write Pegasus Imaging Corp.;
  775.     4350 W. Cypress Street, Suite 908; Tampa, FL  33607; Phone 800-783-8649,
  776.     FAX 813-287-2059.
  777.     The JPEG file display/conversion use Thomas Lane's wonderful JPEG library.
  778.  
  779.     ADDED FEATURES
  780.  
  781.     VPIC is meant to fill a void not covered by paint programs, and to allow
  782.     very convenient file viewing and conversion between file formats. It is
  783.     not meant to compete with the paint programs, and in general if a Paint
  784.     program does something well (such as cut out a portion of the picture),
  785.     VPIC will not attempt to do it, but you can use VPIC to convert from/to
  786.     the Paint program file format. On the other hand, if you think of a
  787.     feature which would enhance VPIC, please let me know, and I will consider
  788.     adding it to the program.
  789.  
  790.  
  791.     KNOWN PROBLEMS
  792.  
  793.     The PROBLEMS file that accompanies VPIC contains info on all known
  794.     problems, and for most, workarounds that will allow you to use VPIC.
  795.  
  796.     SUPPORT FOR OTHER SUPERVGA BOARDS
  797.  
  798.     I will try to support other VGA boards with extended VGA modes if the
  799.     owners will write me with the details of how to set the various modes,
  800.     and how to bank switch the display memory. Of course, if you also
  801.     register VPIC I will give the problem more consideration. Use of a board
  802.     is mandatory, since I can't tell if the new routines work unless I can
  803.     try them.
  804.  
  805.     The bank switching Info for some of the 'not so common' VGA boards is
  806.     hard to come by,  and is needed if VPIC is to support extended VGA modes
  807.     for these boards. A VGA board needs to bank switch for extended modes
  808.     because there is only a 64K window in the PC address space for graphics
  809.     memory (from A000 to AFFF), and extended modes require more than 64K of
  810.     memory; 640x480x256 requires 307200 bytes of memory, or about 4.7 'banks
  811.     of 64K'. Bank switching is a means of mapping the (A000 to AFFF)
  812.     graphics address space into 64K chunks of actual display memory. The
  813.     method of bank switching is determined by the VGA chip used on the
  814.     display board, and what I need is info on how to switch banks and how to
  815.     set the various modes the board supports.
  816.  
  817.  
  818.     USEFUL TECHNIQUES
  819.  
  820.     Running With your Favorite Options
  821.  
  822.     If you like to run VPIC with a particular set of options,  you can put
  823.     VPIC in a directory NOT in your path, and make a batch file which IS in
  824.     your path which calls VPIC with the options as follows:
  825.       @echo off
  826.       x:\vpicdir\vpic /options %1 %2 %3 %4 %5 %6
  827.     where x:\vpicdir is the drive and directory where VPIC resides, and the
  828.     %1..%6 pass other options to VPIC.
  829.  
  830.     Batch Conversions (Sort of)
  831.  
  832.     If you run VPIC in auto mode (/a or F7) and mark the files you want to
  833.     convert, the first picture is displayed when you press Enter. When the
  834.     picture is on the screen, you press the desired conversion command,  and
  835.     when VPIC is done with the conversion, you just press Enter to view the
  836.     next picture, and so on. With this technique, you can mix file types for
  837.     conversion.
  838.  
  839.  
  840.     HOW VPIC OPERATES
  841.  
  842.     VPIC decodes a picture file directly to screen memory on your display
  843.     card. The other technique is to decode to CPU (normal) memory and then
  844.     copy the picture (or a portion of it) to screen memory. Both ways have
  845.     their advantages and disadvantages.
  846.  
  847.     DECODING DIRECTLY TO SCREEN MEMORY (LIKE VPIC).
  848.  
  849.     ADVANTAGES - This method offers the best speed, since it doesn't have to
  850.     go thru the intermediate step of decoding to CPU memory first. It will
  851.     also always decode large pictures, even above the maximum display size.
  852.     The CPU method usually doesn't have sufficient memory for large pics,
  853.     like 1024x768x256, or even 800x600x256 if you have any TSR's in memory;
  854.     these pics require 1 byte/pixel.
  855.  
  856.     The file conversion options uses the current palette data and the
  857.     current data in display memory to make the new file. Thus, what you see
  858.     is what you get in a new file format, in whatever mode you are viewing
  859.     (256 or 16 color).
  860.  
  861.     DISADVANTAGES - Because the picture is decoded directly to screen
  862.     memory, any picture data beyond the right edge of the screen is thrown
  863.     away. For this reason, you can't scroll left and right.  VPIC will
  864.     continue to decode to display memory beyond the bottom of the screen
  865.     until it runs out of memory, set by BANKS in the configuration file. If
  866.     the card wraps memory beyond the bottom of the screen back onto the
  867.     screen, like the Video 7 cards, then VPIC doesn't decode beyond the
  868.     screen bottom.
  869.  
  870.     Thus, if your display card doesn't wrap display memory, you will be able
  871.     to scroll the picture up and down.
  872.  
  873.     If the screen doesn't display the whole picture width, any converted
  874.     file will be truncated on the right edge to the screen size.
  875.  
  876.     DECODING TO CPU MEMORY FIRST
  877.  
  878.     ADVANTAGES - If there is sufficient CPU memory to hold the whole picture
  879.     (at 1 byte/pixel), a rectangular area equal to the screen size can be
  880.     copied to display memory, which allows you to scroll around the picture
  881.     in all directions.
  882.  
  883.     DISADVANTAGES - If there is not sufficient CPU memory, most of the
  884.     programs will refuse to display the picture. There is also the wait
  885.     while the picture is decoded to CPU memory before you get to see it.
  886.  
  887.     VPIC TERMS AND CONDITIONS
  888.  
  889.     NOTICE - VPIC is not free software. If you paid a "public domain" vendor
  890.     for this program, you paid for the copy and mailing service only, and
  891.     not for the program itself. Nothing ever gets to the author of the
  892.     program from such a sale. You may evaluate VPIC for 10 days, and if you
  893.     find it useful, you must register your copy.
  894.         There are several incentives for registering VPIC 6.x. You get the
  895.     secret to disabling the shareware message when VPIC quits, you get free
  896.     technical support (which can be quite valuable at times), you can get
  897.     updates from me (with about 1M of good GIFs) for $5 ($10 foreign) to
  898.     cover shipping and handling, and you allow me to stay in business and
  899.     improve the program. VPIC has been evolving since 1987, and new features
  900.     and/or video card support are added all the time. I have tried to make it
  901.     as versatile and fast as possible, while still retaining the ease of use
  902.     and intuitive operation.
  903.  
  904.     Use of this software is permitted only only to the extent reasonably
  905.     required to determine whether to purchase the software. After payment is
  906.     made, use of this software is limited to use on a single personal
  907.     computer or workstation which is not used as a server. An additional
  908.     payment is required for each use on another personal computer or
  909.     workstation.
  910.  
  911.     VPIC is copyrighted software, and all rights are reserved. VPIC may not
  912.     be changed or modified in any way except by the author. VPIC is
  913.     SHAREWARE, and may be freely distributed, as long as it remains in its
  914.     complete form with all support, documentation, and configuration files.
  915.     It may be used for a ten day free trial period. Regardless of how the
  916.     copy is obtained, it is requested that all users comply with the
  917.     following licensing/registration provisions if they continue to use it
  918.     after the 10 day trial period. Use of VPIC after the 10 day free trial
  919.     period constitutes acceptance of these terms.
  920.  
  921.     1.  $25 per copy for individual users. Users can feel free to use VPIC
  922.         for anything. I need your name and address for my records, and you
  923.         are entitled to:
  924.         a. Use all updates at no cost (except shipping and handling; see
  925.            below) provided the registration fee hasn't changed.
  926.         b. Technical support either by phone (you call me) or by letter.
  927.         c. If you order the latest version along with your registration (see
  928.            below), you also get a printed manual.
  929.     2.  Site License: $125 per 10 copies if used or distributed by you, or
  930.         as part of your product. All users would be registered collectively
  931.         under your name, but can fell free to use VPIC for anything. Update
  932.         requests and technical support would be thru you (since I don't know
  933.         the names of the individual users) and would be distributed by you
  934.         to the users.
  935.     3.  Quantity discounts: (Only one disk provided, you keep track of users
  936.         and provide support)
  937.         10 to 99: $17.50 per copy.
  938.         100 to 1000 up: $12.50 per copy.
  939.         1000 up: $10 per copy.
  940.         All registered users can feel free to use VPIC for anything. You can
  941.         get technical support from me, and pass it on to your customers.
  942.         Please provide me with a list of the user names and addresses, so I
  943.         can honor update requests.
  944.     4.  a. $1.70/copy royalty if used as part of a DEMO; a demo is not part
  945.            of your product, but is a means of advertizing your product. $0.20
  946.            of this fee is a royalty paid to Unisys for GIF & TIFF LZW compression.
  947.         b. $3/copy royalty if used as a utility for running your product. The
  948.            maker of the demo/product must be a registered user. If a recipient
  949.            of the disk uses VPIC for other purposes (not part of the demo or
  950.            product) he must register. You must sign a royalty agreement with me,
  951.            and make payments annually. You may estimate the yearly usage, and
  952.            then correct it from year to year. You should supply to me a written
  953.            statement listing the copies shipped each year. $0.20 of this fee is
  954.            a royalty paid to Unisys for GIF & TIFF LZW compression.
  955.  
  956.            For foreign orders, please send a check drawn on a US Bank,
  957.            International or US Postal Money Order, Travelers Checks, or cash,
  958.            since the banks here charge up to $60 collection fee for foreign
  959.            checks.
  960.  
  961.     For large quantities, please call. The maker of a demo/product must be a
  962.     registered user of VPIC. You shall state in your documentation that you
  963.     have a license to use VPIC for the demo/product, and that if a recipient
  964.     of the disk uses VPIC for other purposes (not part of the demo/product)
  965.     he should register. You shall sign a Utility or Demo License agreement
  966.     with me, and make payments at least anually. You may estimate the yearly
  967.     usage, and then correct it from year to year. You shall supply to me a
  968.     written statement listing the copies shipped each year, and shall make a
  969.     down payment covering the first 15 copies.
  970.  
  971.     For foreign orders, please send a check drawn on a US bank, an
  972.     International, American Express, or US Postal money order, Travelers
  973.     checks, cash, or credit card data (card number, expiration date, and
  974.     authorizing signature). The banbsk here charge up to $60 collection fee
  975.     for foreign checks, and $12 for direct wire transfers. VPIC is sent by
  976.     AirMail with proper customs info, so should arrive within 10 days.
  977.  
  978.     For all the above, VPIC should be distributed intact, with all
  979.     documentation (DOC files), support programs (CVPIC, CONFIG, and
  980.     WHICHVGA), and configuration (.CFG) files. Archived form is OK to meet
  981.     this requirement, since it minimizes disk space, if you supply the
  982.     un-archiving program.
  983.  
  984.     A user may install VPIC on more than one machine, provided he is the
  985.     only user on each machine. The registration and license policy is
  986.     similar to a book, which can be taken with you but used only by you.
  987.  
  988.     Please use the enclosed registration/order form since it allows me to
  989.     keep better records and keep up with the newer VGA boards.
  990.  
  991.     UPGRADES FROM PREVIOUS PROGRAMS AND UPDATES
  992.  
  993.     You may use all updates (with the same registration fee) free once you
  994.     have registered VPIC. You may upgrade to VPIC 6.x for the difference in
  995.     registration fee. If you are already registered for VGIF or ZS (any
  996.     version) you may upgrade to VPIC for an additional $15. Upgrading from
  997.     VPIC 5.x or below is $10. In any case, if you want to get the latest
  998.     version. please add $5 ($10 foreign) to cover shipping and handling.
  999.     Since VPIC is updated regularly, I do not send notices, but it gets
  1000.     around quickly to most graphics oriented BBS's, and is available at
  1001.     Compuserve in Data Library 3 of the PICS forum.
  1002.  
  1003.  
  1004.     ORDERS FROM ME
  1005.  
  1006.     Only registered users of ver 6.x can get VPIC updates from me. If you
  1007.     order a VPIC update from me, please send $5 ($10 outside the USA and
  1008.     Canada) for materials, postage, and handling. As a bonus I will fill the
  1009.     rest of the disk with good pictures. Please specify 1.2Meg 5.25" disk or
  1010.     1.44M 3.5" disk, and EGA, VGA, or SuperVGA (640x480x256 etc) so I'll know
  1011.     what pictures to send. I have some 1024x768x256 pictures, but most are
  1012.     about 500K in size and eats up a sizeable portion of a disk, so if you
  1013.     want one of these there wont be much room for other pictures. If you want
  1014.     additional disks of pictures, please add $5/disk (3 disks max). I have
  1015.     quite a few 640x480x256 pictures (mostly by Boris Vallejo), only 1 disk
  1016.     full of 320x200x256 pictures and 1 disk of EGA pictures, and a few larger
  1017.     sizes.
  1018.  
  1019.     Data on the various file formats VPIC supports is available free if you
  1020.     request it with your order, but will use about 200K of disk space.
  1021.  
  1022.     Please use the enclosed registration/order form since it allows me to
  1023.     keep better records and keep up with the newer VGA boards.
  1024.  
  1025.     DISCLAIMER
  1026.  
  1027.     All warranties are disclaimed, including damage to hardware and/or
  1028.     software from use of this product. In no event will I be liable to you
  1029.     for any damages, including lost profits, lost savings or other
  1030.     incidental or consequential damages arising out of your use or inability
  1031.     to use the program, or any other claim by any other party.
  1032.  
  1033.     SPECIAL VERSIONS - I normally don't want to modify VPIC, since it is too
  1034.     hard to maintain multiple versions of the same program. With all the
  1035.     switches and controls, VPIC can usually be made to do what you want
  1036.     without modification. However, I am open to suggestions on how to improve
  1037.     VPIC, and if they seem reasonable, and not too hard to implement, I will
  1038.     usually incorporate them. Any suggestions should be mailed to:
  1039.         Bob Montgomery - VPIC Inc.
  1040.         P.O Box 162857
  1041.         Altamonte Springs, FL  32716-2857
  1042.         Phone & FAX: 407-869-5233
  1043.  
  1044.     GRAPHICS ORIENTED BBS'S
  1045.  
  1046.     Compuserve PICS Forum (My ID is 73357,3140)
  1047.     Magic City USA, Orlando, Florida 1.0 Gig Online;  Modems: 2400 baud
  1048.         (407) 628-2546, HST (407) 628-0185
  1049.     Tsunami BBS, Half Moon Bay, Calif. (415) 726-2726
  1050.     PC Rockland, S. Nyack, NY (914) 353-2538 [Freeboard] 1.6 Gbyte Online
  1051.     Megabyte Image Center   (918) 492-0087 1200/2400/9600 baud USR HST
  1052.     Pictures and Scanning Services:
  1053.     Event Horizons: Catalog, 311 Avenue "B", Suite 209, Lake Oswego, OR
  1054.      97034 Order:503-697-7700,Modems:(1200/2400) 503-697-5100,
  1055.      (9600HST) 503-697-5126
  1056.     JPix Graphics Imaging: Modems:(2400) 219-267-2188, (9600) 219-267-8528
  1057.     Tech's Warehouse BBS, Jacksonville, Florida (904) 260-9283                                            APPENDIX A - REVISION HISTORY
  1058.                                APPENDIX                                Page A1
  1059.     HISTORY OF VGIF
  1060.  
  1061.     VGIF ver 1.1  1-13-88
  1062.     *   Added test for EGA adapter.
  1063.     *   Fixed menu colors.
  1064.     *   Allow [ESC]ape from marked file viewing.
  1065.     *   Added [Ctrl-Break] or [Ctrl-C] exit to DOS anywhere.
  1066.     *   Added 'disk full' notification when creating picture file.
  1067.     *   Added critical error handler for 'drive not ready' errors.
  1068.  
  1069.     VGIF ver 1.2  1-15-88
  1070.     *   Changed name to VGIF.
  1071.     *   Slide mode now ignores the end of file mark in slide file, and any
  1072.         key will now end slide mode.
  1073.     *   Added slides to menu mode if [S] pressed-shows marked files as
  1074.         slides until a key is pressed.
  1075.  
  1076.     VGIF ver 1.3  1-21-88
  1077.     *   Added better error checking to GIF file decoding. Notifies if bad
  1078.         GIF file.
  1079.     *   Fixed error reporting bug in single file mode.
  1080.  
  1081.     VGIF ver 1.4  2-9-88
  1082.     *   Added instantaneous screen update in slide mode from menu or command
  1083.         (SLD) file.
  1084.     *   Added the /r option which allows an application program to call VGIF
  1085.         to view a file and then regain control.
  1086.  
  1087.     VGIF ver 1.5  3-2-88
  1088.     *   Added [PgUp] and [PgDn] keys to scroll by 10 lines at a time.
  1089.     *   Added a max pic height of 819 lines so EGA buffer would not overflow.
  1090.     *   Greatly improved color reproduction for 'problem' pictures (such as
  1091.         FROG, ARCHIT, PUFFIN, VEGTABLE, etc). These pictures typically have
  1092.         more than 16 colors. Selected colors on basis of frequency of use
  1093.         where possible.
  1094.     *   Fixed following bugs:
  1095.         1. Line buffer would overflow into other variables if pic width was
  1096.            > 640 pixels, causing strange results.
  1097.         2. Didn't recognize the end of image marker correctly. This would
  1098.            cause the palette to change when the image was done.
  1099.  
  1100.     VGIF ver 1.6  3-11-88
  1101.     *   Fixed a bug in handling multiple images. First noticed when viewing
  1102.         WHIMMI.GIF.
  1103.     *   Use same palette for multiple images, and get best color match.
  1104.     *   Added [L] and [S] commands while viewing a picture. These allow you
  1105.         to create full size paint program files.
  1106.                                                                        Page A2
  1107.     VGIF ver 2.0  3-26-88
  1108.     *   Added the ability to view long GIF files ( > 819 lines) without
  1109.         wrapping the display.
  1110.     *   Added the [C] and [H] (Dr. Halo) file creation option while viewing.
  1111.     *   Added the [L] and [S] prefix to paint program file creation commands
  1112.         while viewing to save long pic files.
  1113.     *   Added the Info and Help commands in menu mode.
  1114.     *   Deleted the # requirement to specify a directory from the command
  1115.         line. The program now looks for a directory which meets the spec on
  1116.         the command line. If none is found, it assumes the spec is for a
  1117.         single file.
  1118.     *   Added [F1 - F10], and [V] palette control keys while viewing a file.
  1119.  
  1120.     VGIF ver 3.0  5-2-88
  1121.     *   Added VGA capability, and support for Tseng extended VGA modes
  1122.         (640x480x256 and 800x600x256).
  1123.     *   Determines and displays available modes for your system.
  1124.  
  1125.     VGIF ver 3.1  5-11-88
  1126.     *   Fixed a bug in dir/file spec from command line. Now accepts VGIF
  1127.         d:\dir\*.gif or VGIF d:*.gif, although the [\]*.gif is not required,
  1128.         since this is the default filespec.
  1129.     *   Fixed a bug in forced EGA when doing slides, where an interlaced pic
  1130.         displayed at double size would have a 'venetian blind' effect.
  1131.     *   Changed so pics larger than 320x200 are shown in 640x480 VGA; can
  1132.         get 800x600 by pressing + key.
  1133.     *   The EGA mode on the Orchid VGA card appears squashed vertically.
  1134.         This is normal, and cannot be corrected without reprogramming the
  1135.         parameters for mode 16, which would change the vertical retrace
  1136.         frequency and probably cause your monitor to roll.
  1137.  
  1138.     VGIF ver 3.2  5-26-88
  1139.     *   Added 500 file menu, and assy language text screen updating; now
  1140.         super fast.
  1141.     *   Fixed a bug which caused the Vega VGA card to hang up.
  1142.  
  1143.     VGIF ver 3.3  6-9-88
  1144.     *   Added user spec of video mode for non-Orchid VGA boards.
  1145.     *   Added GIF and Pictor save of current screen for VGA/EGA pics.
  1146.     *   Added prompts to screen for conversion to other formats.
  1147.     *   Removed conversion starting at first visible row-now does whole pic.
  1148.  
  1149.     VGIF ver 3.4  6-23-88
  1150.     *   Fixed a bug in the GIF save routine.
  1151.     *   Added color, contrast, and brightness adjustment in VGA.
  1152.     *   Fixed a bug in menu mode for marked files.
  1153.     *   Added /n command line option to stay in 640x480x256 for VGA pics.
  1154.  
  1155.     VGIF ver 3.5  7-14-88
  1156.     *   Fixed some misc minor bugs.
  1157.     *   Added increase/decrease resolution command while viewing 16 color
  1158.         VGA pics (using the /e option).
  1159.     *   Added slide mode for VGA.
  1160.     *   Added lock mode option to start pics from the menu in a desired mode.
  1161.  
  1162.     VGIF ver 3.6  8-8-88
  1163.     *   Fixed some bugs.
  1164.     *   Fixed EGA slide show.
  1165.                                                                        Page A3
  1166.     VGIF ver 3.6A 9-10-88
  1167.     *   Fixed 1024x768x16 mode.
  1168.  
  1169.     VGIF ver 4.0  10-20-89
  1170.     *   This was a beta test version which got out. It had lots of bugs,
  1171.         which were fixed in VPIC.
  1172.  
  1173.     HISTORY OF VPIC
  1174.  
  1175.     VPIC ver 1.0 & 1.1 12-27-88
  1176.     *   Beta test versions.
  1177.  
  1178.     VPIC ver 1.2  12-27-88
  1179.     *   Added configuration option for various display boards.
  1180.     *   Added VGA file conversion for all previous Paint programs supported.
  1181.     *   Added Deluxe Paint 2 conversion.
  1182.     *   Added Targa 16 file conversion.
  1183.     *   Added EGA/VGA toggle from menu.
  1184.     *   Added default resolution select, and Mode Lock key from menu.
  1185.     *   Added WAIT option to pause between images of multi-image files.
  1186.     *   Added MAC, PCX, & Colorix file viewing capability. Others will be
  1187.         added in later versions.
  1188.     *   Added 'animate' while viewing.
  1189.     *   Fixed VGA 16 color palette.
  1190.  
  1191.     VPIC ver 1.2A  1-4-89
  1192.     *   Fixed MAC -> GIF conversion
  1193.     *   Fixed CVPIC for ^Z as EOF char.
  1194.     *   Fixed 16 color palette for other file formats if VGA 16 colors.
  1195.  
  1196.     VPIC ver 1.3  2-2-89
  1197.     *   Fixed cursor in menu.
  1198.     *   Fixed 'lock up' if GIF header size wrong (640x350 labeled 350x640).
  1199.     *   Now pauses pic if file error and waits for key press-can see partial
  1200.         pics in bad files this way.
  1201.     *   Shows GIFs with MAC headers (1st 128 bytes are not GIF standard); if
  1202.         F3 (info) pressed shows if file has a MAC header.
  1203.     *   Fixed so views and saves new Zsoft VGA PCX files which include
  1204.         palette at end of file. Still doesn't load PAL files.
  1205.     *   Fixed Zsoft file displays and saves.
  1206.     *   Added Wait toggle (F8) which pauses between images in multi-image
  1207.         GIFs, and allows conversion to other filetypes.
  1208.     *   Made MACs black on bright white instead of gray.
  1209.  
  1210.     VPIC ver 1.4  3-15-89
  1211.     *   Added printout of filename while decoding except in slide mode.
  1212.     *   Added help while viewing a picture; press [?] or [/].
  1213.     *   Added delete a file option [X] (with query) while viewing.
  1214.     *   Added hit [ESC] while decoding to abort picture.
  1215.  
  1216.     VPIC ver 1.5  3-23-89
  1217.     *   Fixed bug in 'Escape while decoding' which would hang system.
  1218.     *   Fixed EGA x2 display for interlaced files.
  1219.     *   Fixed problem with saving a pic after scrolling.
  1220.     *   Fixed palette in animate, so save will use current palette.
  1221.     *   Fixed problem with bad files in slide mode that would hang computer.
  1222.     *   Fixed error display in /@ slide mode and single file mode.
  1223.                                                                        Page A4
  1224.     VPIC ver 1.6  4-5-89
  1225.     *   Fixed bugs in slide show from command file. Added comments.
  1226.     *   Added resolution option for each picture in slide command file.
  1227.     *   Fixed miscellaneous minor bugs.
  1228.     *   Added configurable menu color.
  1229.  
  1230.     VPIC ver 1.7  6-13-89
  1231.     *   Added Trident chip set support (for Maxxon and Logix VGA boards and
  1232.         maybe the ATI board).
  1233.     *   Fixed a few bugs concerned with putting & getting lines from the
  1234.         display screen.
  1235.     *   Fixed problem with Ctrl Z at end of slide definition file.
  1236.  
  1237.     VPIC ver 1.8 6-28-89
  1238.     *   Added EGA Paint viewing/conversion.
  1239.     *   Fixed conversion to 800x600 ColoRIX file.
  1240.     *   Fixed other minor bugs.
  1241.  
  1242.     VPIC ver 1.9 7-19-89
  1243.     *   Added inverted, mirrored, and rotated GIF saves.
  1244.     *   Fixed a bug in the Dr Halo CUT file creation.
  1245.     *   Added menu updating after file creation or deletion.
  1246.     *   Added new path spec feature from menu with [F9] key.
  1247.  
  1248.     VPIC ver 2.0 8-6-89
  1249.     *   Added Pictor/PC Paint PIC, Dr. Halo CUT, Deluxe Paint LBM, and Targa
  1250.         16 or 24 file viewing capability.
  1251.     *   Fixed a bug in the palette selection for EGA.
  1252.     *   Fixed bug which would not show VGA for the plain vanilla VGA config.
  1253.     *   Fixed a bug in the Zsoft PCX display for extended EGA modes.
  1254.     *   Added Auto resolution option and switch from the menu [F7].
  1255.     *   Made cursor stay fixed when files are created or deleted.
  1256.     *   Added Chips & Technology support. (VPIC 2.0A)
  1257.     *   Fixed Zsoft save at higher screen resolution than pic. (VPIC 2.0B)
  1258.  
  1259.     VPIC ver 2.1  9-5-89
  1260.     *   Fixed a bug in LBM viewing
  1261.     *   Added ColoRIX 16 color SCR and SCP view/create.
  1262.     *   Speeded up GIF decoding about 50%.
  1263.  
  1264.     VPIC ver 2.1A 9-10-89
  1265.     *   Fixed a memory allocation problem for slides.
  1266.     *   Made small increase in speed.
  1267.     *   Fixed directory callout (*.PIC, etc).
  1268.     *   Re-enabled [ESC] for GIF viewing.
  1269.     *   Fixed Chip & Tech bank switching routine.
  1270.     *   Fixed Deluxe Paint II (LBM) file creation.
  1271.  
  1272.     VPIC ver 2.2 10-23-89
  1273.     *   Fixed problem in new path command ([F9] from menu).
  1274.     *   Fixed intermittent GIF decode problem.
  1275.     *   Program now tells if GIF image and screen sizes conflict.
  1276.     *   Menu now correctly displays file sizes larger than 1 Mbyte.
  1277.     *   Now lists & displays Electronic Arts IFF files (same as LBM).
  1278.                                                                        Page A5
  1279.     VPIC ver 2.3 12-13-89
  1280.     *   Fixed C_T bank switching.
  1281.     *   Added Everex 678, Ahead (B chip), and Genoa 6400 support.
  1282.     *   Fixed bugs in GIF and Pictor decoder.
  1283.  
  1284.     VPIC ver 2.4 12-28-89
  1285.     *   Fixed bug in GIF decoder for very wide pics.
  1286.     *   Fixed palette for many file types.
  1287.     *   Fixed slide mode from menu.
  1288.  
  1289.     VPIC ver 2.5 1-28-90
  1290.     *   Fixed single file and /r modes.
  1291.     *   Fixed Pictor viewing for B&W pics.
  1292.     *   Fixed MAC header interpretation problem.
  1293.     *   Fixed memory clearing for pictures longer than the screen.
  1294.     *   Added F10 to menu to display current path. Menu no longer shows
  1295.         complete path (only filespec) to avoid clutter with long paths.
  1296.     *   Deleted path from filename display when showing picture.
  1297.     *   Added SCY conversion for ColoRIX.
  1298.     *   Added Zymos VGA chip support.
  1299.     *   Corrected CVPIC to allow more than 9 banks in config file.
  1300.  
  1301.     VPIC ver 2.6 1-28-90
  1302.     *   Fixed palette for 2 color GIFs.
  1303.     *   Fixed SCU display in 1024x768x16 mode.
  1304.     *   Fixed Pictor EGA and ColoRIX EGA slide viewing.
  1305.  
  1306.     VPIC ver 2.7 3-17-90
  1307.     *   Fixed GIF bug and palette for files with local color maps.
  1308.     *   Added /b command line option to beep after a picture is decoded
  1309.         except in slide modes.
  1310.     *   Added Alt_F command while viewing a picture to momentarily display
  1311.         the file name.
  1312.     *   Fixed Targa viewing for all sizes; now handles RLE images too.
  1313.  
  1314.     VPIC ver 2.8 3-27-90
  1315.     *   Added /h command line option to find hidden files.
  1316.     *   Changed menu display to allow up to 8 modes for VGA or EGA.
  1317.     *   Fixed palette in Dr. Halo CUT files.
  1318.     *   Added Tseng 4000 chip support.
  1319.  
  1320.     VPIC ver 2.9 5-23-90
  1321.     *   Fixed Targa module to handle all 8 thru 32 bits/pixel formats.
  1322.     *   Added copyright messages.
  1323.     *   Fixed PCX viewing for gray scale files.
  1324.  
  1325.     VPIC ver 2.9A 7-1-90
  1326.     *   Fixed Targa module for files which don't follow the compression
  1327.         rules of 'don't overrun lines'. Added TGA expand option [E] while
  1328.         viewing a RLE compressed Targa file.
  1329.     *   Fixed conversion routines so they save the pictures size. This was a
  1330.         bug that crept into ver 2.9.
  1331.     *   Added ESC to abort deleting a file with [Alt_X].
  1332.     *   Added file types (where applicable) to the info command [F3] from
  1333.         the menu.
  1334.     *   Added uncompressed ColoRIX SCO file (1024x768x256) support.
  1335.     *   Fixed a bug in CVPIC.
  1336.     *   Fixed a bug which prevented working with DOS 4.x.
  1337.                                                                        Page A6
  1338.     *   Added Deluxe Paint II enhanced viewing and save capability.
  1339.     *   Fixed a color bug in Targa 32 viewing.
  1340.  
  1341.     VPIC ver 3.0 9-15-90
  1342.     *   Added capability to view the new GIF89a files, and FRA fractal files.
  1343.     *   Added delay and user response features of GIF89a.
  1344.     *   Fixed a bug which would hang the computer if you deleted the last
  1345.         viewable file from a directory.
  1346.     *   Added prompt for a file conversion, allowing you to escape.
  1347.     *   Added C&T, as well as the previous C_T, which VPIC will accept as
  1348.         the Chips & Technologies VGA chip in the config file.
  1349.     *   Fixed memory allocation bug in PCX creation for 1024x768x256 images.
  1350.  
  1351.     VPIC ver 3.1 9-25-90
  1352.     *   Added flexibility to slide mode. Always decodes to memory and can
  1353.         change delay for files; see the section on 'vpic /@slidesfile`.
  1354.  
  1355.     VPIC ver 3.2 10-29-90
  1356.     *   Fixed the bank switching for the Trident 8800 chip.
  1357.     *   Fixed a palette problem when viewing Targa files.
  1358.  
  1359.     VPIC ver 3.3 11-5-90
  1360.     *   Fixed problem with lines on VGA pics in slide mode.
  1361.     *   Added animate command in slide command file, and speed control for
  1362.         animation.
  1363.     *   Fixed MCGA 16 color palette.
  1364.     *   Fixed ATI 1024x768x16 slide mode.
  1365.  
  1366.     VPIC ver 3.4 11-21-90
  1367.     *   Fixed most conversion routines so they work in ATI 1024x768x16 mode;
  1368.         can't do EGA Paint or 16 color ColoRIX, or Pictor EGA files.
  1369.     *   Fixed most viewing routines so they work in ATI 1024x768x16 mode;
  1370.         can't do EGA Paint or 16 color ColoRIX, or Pictor EGA files.
  1371.     *   Fixed bugs in conversion for pics less than screen width wide.
  1372.     *   Cleaned up numerous small bugs.
  1373.     *   Added BIF Binary Image File from B&W image capture boards.
  1374.  
  1375.     VPIC ver 3.5 12-15-90
  1376.     *   Added 64 shade gray conversion for VGA images (press b while viewing).
  1377.     *   Added auto-centering for pictures smaller than the screen.
  1378.     *   For slides, now displays as much of picture as memory will allow.
  1379.  
  1380.     VPIC ver 4.0 02-13-91
  1381.     *   Added GIF89a features including transparent color, variable size
  1382.         plain text, user input, variable delay, and display of comments.
  1383.         Works in all EGA and VGA modes.
  1384.     *   Fixed all file conversions so they work with centered images.
  1385.     *   Improved palette selection, and made hi contrast help messages.
  1386.  
  1387.     VPIC ver 4.0a 02-20-91
  1388.     *   Added OAK and new ATI (with normal 1024x768x16 mode) card.
  1389.     *   Added `whichvga' program to try to identify your VGA chip.
  1390.                                                                        Page A7
  1391.     VPIC ver 4.1 03-15-91
  1392.     *   Added Microsoft Windows 3.0 Bitmap BMP file viewing/saving in
  1393.         compressed or uncompressed format. Sometimes uncompressed is smaller
  1394.         than compressed.
  1395.     *   Changed VGA chip designators, added VGA chips; see CONFIG.DOC. Be
  1396.         sure to use the version of CVPIC supplied with this version of VPIC.
  1397.  
  1398.     VPIC ver 4.2 04-10-91
  1399.     *   Fixed palette bug which would reverse black and white in some pictures.
  1400.     *   Fixed menu when disk was rescanned.
  1401.  
  1402.     VPIC ver 4.3 04-27-91
  1403.     *   Added x and y offset, and inhibit filename display, from command
  1404.         line using /x, /y, and /z options.
  1405.     *   Added overlaying of pictures onto display using the 'F' command
  1406.         while viewing a picture.
  1407.  
  1408.     VPIC ver 4.3a 05-05-91
  1409.     *   Fixed ATI VGA Wonder scrolling.
  1410.  
  1411.     VPIC ver 4.3b 05-15-91
  1412.          Fixed EGA palette.
  1413.  
  1414.     VPIC ver 4.4 07-09-91
  1415.     *   Added mouse support for the menu screen (so far).
  1416.     *   Added Viewpoint picture viewing (.PIC files).
  1417.     *   Added wider selection of menu colors; see CONFIG.DOC.
  1418.     *   Added a mode set from the command line.
  1419.     *   Added 1280x1024 EGA modes (DEFINICON.CFG)
  1420.     *   Fixed a bug in the BMP decoder for OS/2 PM files.
  1421.     *   Fixed a bug in slides mode.
  1422.  
  1423.     VPIC ver 4.5 08-05-91
  1424.     *   Added full VESA autodetect and use for all 16 and 256 color modes.
  1425.     *   Added mouse support in the menu.
  1426.     *   Added Tseng ET-4000 HiColor (32K colors) support for Targa files.
  1427.  
  1428.     VPIC ver 4.5a 08-15-91
  1429.     *   Did some cosmetic fixes for mouse operation.
  1430.     *   Marked files now don't stay marked when you change directories.
  1431.     *   Added 2 pages of comment storage for GIF89a file.
  1432.  
  1433.     VPIC ver 4.6 08-23-91
  1434.     *   Fixed a VESA related problem with late STB boards.
  1435.     *   Added /v command line option to ignore VESA info and use config file
  1436.         data.
  1437.     *   Fixed a Windows BMP problem; removed compressed option for conversion.
  1438.     *   Fixed GIF89a with comments problem.
  1439.  
  1440.     VPIC ver 4.7 never released
  1441.         Someone tried to add the Dark Avenger virus to VPIC in the Boston
  1442.         area. You can't change a single byte in VPIC or it will refuse to
  1443.         run, since it does a checksum on itself. They used a batch file or
  1444.         some other sneaky thing, and had the virus assemble and execute
  1445.         after exiting VPIC. It was not detected by Central Point Virus Scan,
  1446.         since it wasn't an EXE or COM file, but was detected by someone
  1447.         there who sent me a letter with the name and phone number of the
  1448.         person who uploaded it. The FBI is currently investigating it.
  1449.                                                                        Page A8
  1450.     VPIC ver 4.8 02-25-92
  1451.     *   Fixed BMP viewing and conversion so Windows will read all files
  1452.         created by VPIC (compressed too), and VPIC will view all files that
  1453.         windows does. Change RLE extension to BMP for viewing compressed
  1454.         BMP's.
  1455.     *   Added general means of telling VPIC in the configuration file about
  1456.         the presence of the Sierra DAC and what modes it works in.
  1457.     *   Updated CVPIC to work with new CFG files.
  1458.     *   VPIC now comes up with mouse cursor out of the way in upper right
  1459.         corner.
  1460.     *   Added /l option for putting another picture on the screen from an
  1461.         application; doesn't change the video mode.
  1462.     *   Added Alt_D from menu to change the slide delay for marked files.
  1463.     *   Added QUIT command in slide command file to do just 1 pass and quit.
  1464.     *   Fixed numerous minor bugs in ver 4.6.
  1465.     *   Added S3 VGA chip (Orchid Fahrenheight 1280, Genoa Windows VGA, etc).
  1466.  
  1467.     VPIC ver 4.8a 03-10-92
  1468.     *   Fixed minor bug in /m command and updated help screen.
  1469.     *   Fixed conversion to 16 color Windows BMP.
  1470.     *   Fixed menu file marking bug where spacebar was ignored after marking
  1471.         files with mouse.
  1472.  
  1473.     VPIC ver 4.8b 04-08-92
  1474.     *   Fixed bug in marked file viewing when saving or deleteing a file.
  1475.     *   You can now lock the mode for marked file slide viewing.
  1476.     *   Added Uncompressed DPII conversions.
  1477.  
  1478.     VPIC ver 4.8c 04-20-92
  1479.     *   Fixed a bug in VESA module for boards with dual VESA windows.
  1480.     *   Updated CVPIC to handle VESA windows.
  1481.     *   Added internal character table for boards which don't have
  1482.         characters built into Video BIOS (S3 in extended modes, 8514A, etc).
  1483.     *   Fixed an annoying bug when you pressed ESC to end slide mode.
  1484.     *   Fixed ATI viewing in mode 55h (1024x768x16).
  1485.  
  1486.     VPIC ver 4.8d 06-01-92
  1487.     *   Added NCR (NCR.CFG) and REALTEK (REALTEK.CFG) VGA chip.
  1488.     *   Fixed bug in uncompressed BMP viewing and conversion for odd sizes.
  1489.     *   Eliminated palette colors swapping for text readability.
  1490.     *   Added 24 bit color (65 million colors) for Genoa 7900 (GENO7900.CFG)
  1491.         and Diamond Speedstar 24 (DIAMON24.CFG), and possibly others. This
  1492.         and the 32K color modes don't support file conversion or help yet,
  1493.         and are mainly there as a convenience to the user.
  1494.  
  1495.     VPIC ver 4.9  Never released
  1496.         This was a Beta test version I sent to someone with a specific
  1497.         request not to upload it anywhere. Oh well, so much for requests. It
  1498.         may be buggy, and you should get ver 5.0.
  1499.  
  1500.     VPIC ver 5.0  06-18-92
  1501.     *   Added 8514A support. Added 8514A and ATIULTRA config files. Should
  1502.         also work with XGA, and you may be able to add the 800x600 mode.
  1503.     *   Changed Targa info to remove number of colors.
  1504.     *   Changed Targa slides to always decode to screen; mainly to
  1505.         accommodate the 32K and 16M colors modes.
  1506.     *   Added Alt T and Alt U to menu; Alt T (tag) marks all files, and Alt
  1507.         U (untag) unmarks all files.
  1508.                                                                        Page A9
  1509.     VPIC ver 5.0a 07-12-92
  1510.     *   Fixed a problem with the VESA bank switching which caused the screen
  1511.         to overwrite the top portion.
  1512.     *   Fixed a problem with the 8514A (and ATI Ultra) where it wouldn't
  1513.         display the whole picture in 1024x768x256 mode.
  1514.  
  1515.     VPIC ver 5.0b 07-21-92
  1516.     *   Fixed 8 bit Targa display routine.
  1517.     *   VPIC now puts the 'bad code' message for corrupted GIFs at bottom of
  1518.         the screen, leaves the picture on the screen, and goes into command
  1519.         mode. This allows you to save at least a portion of a bad GIF.
  1520.  
  1521.     VPIC ver 5.0c 08-01-92
  1522.     *   Added path specifier to slide command file. This is useful for pics
  1523.         on a CD ROM or other unmodifiable device.
  1524.     *   Added Alt_R in the menu to rename a file. It prompts for a new
  1525.         filename and uses the old extension if you don't give it a new one.
  1526.     *   Added /D command line option to save files to the directory VPIC was
  1527.         called from. The default is the now the directory you're viewing.
  1528.         This is useful for saving CD ROM pictures, that you can't write to.
  1529.  
  1530.     VPIC ver 5.0d 08-20-92
  1531.     *   Separated /x and /y command line parameters so you can spec one and
  1532.         the other will be centered.
  1533.     *   Changed built in help so 'vpic /?' gives help from the DOS command
  1534.         line, F1 gives help from menu, and / or ? gives help while viewing.
  1535.  
  1536.     VPIC ver 5.1  09-03-92
  1537.     *   Fixed VESA bank switching bug.
  1538.     *   Added context sensitive help (command line, menu, conversion).
  1539.     *   Fixed Targa viewer for 24 bit cards and top-down Targa'a.
  1540.     *   Fixed LBM viewer and conversion-added pad bytes when req'd.
  1541.     *   Limited S3 320x200x256 to 1 screen; scrolling not supported by S3.
  1542.     *   Blanked screen between slides.
  1543.     *   Added Compaq Qvision support-didn't work.
  1544.  
  1545.     VPIC ver 5.1a 10-28-92
  1546.     *   Fixed Qvision viewing.
  1547.     *   Added /o option; Doesn't check for EGA/VGA on startup.
  1548.     *   Added /p option; Doesn't swap background for GIF's. Good if you are
  1549.         saving to PCX and going to PC Paintbrush.
  1550.     *   Added /d option; Saves to current dir instead of the viewing dir.
  1551.         Good for CD ROM conversions.
  1552.     *   Added p command to slide files to specify the path for the pictures.
  1553.         Good for CD ROM slideshows.
  1554.     *   Upped file limit to 2000 for the menu. Good for large dirs.
  1555.  
  1556.     VPIC ver 5.1b 11-15-92
  1557.     *   Fixed LBM viewing and conversion.
  1558.     *   Added Primus 2000 Graphics Accelerator.
  1559.     *   Marked files now stay marked when you press Esc from either Slides
  1560.         (F2) or manual viewing with Enter; they can be unmarked by Alt_U
  1561.         from the menu. You can now go to the previous file with Alt_Enter.
  1562.         For marked file viewing with Enter, the viewing continues like a
  1563.         slide show and you press Esc to quit back to the menu.
  1564.  
  1565.     VPIC ver 5.1c 12-04-92
  1566.     *   Fixed grey conversion to give better representation of shades.
  1567.                                                                        Page A10
  1568.     VPIC ver 5.1d 12-10-92
  1569.     *   Added Acumos SVGA chip, used on co-processor boards. Not tested yet.
  1570.     *   Changed to medium memory model to accommodate more program features.
  1571.         This may have caused a few bugs which I haven't found yet. If you
  1572.         find one, please let me know.
  1573.     *   Made help screens also serve as menus.
  1574.     *   Fixed last file viewing in command file slideshows when QUIT used.
  1575.     *   Added Alt_L to menu to set top and left picture margins.
  1576.  
  1577.     VPIC ver 5.1e  3-01-92
  1578.     *   Added VESA chip type to config files for boards which VPIC doesn't
  1579.         support directly but have VESA support built in. This can be accessed
  1580.         by running 'vpic /v' to tell VPIC to ignore built in VESA info, and
  1581.         use the config file info. Also included a VESA.CFG file to play with.
  1582.  
  1583.     VPIC ver 6.0  12-20-92
  1584.     *   Added directory tree when you press Alt F9. Scans current drive for
  1585.         all subdirectories, and presents them in the menu window.
  1586.     *   Added Alt_Z to menu to toggle filename viewing while decoding.
  1587.     *   Added graphics cursor similar to Windows cursor.
  1588.     *   Price Increase: Since 90% of the VPIC registrations want the latest
  1589.         version ($20), and to cover the nifty new features I plan to add,
  1590.         the base price for VPIC was raised to $25 for a single user.
  1591.         Shipping and handling for updates to the latest version (registered
  1592.         users only) is the same at $5 inside the USA and Canada, and $10
  1593.         foreign, and includes about 1M of good GIF pictures. When you
  1594.         register or upgrade from a version prior to 6.0, and get the latest
  1595.         version from me, you also get a printed manual.
  1596.  
  1597.     VPIC ver 6.0a  1-17-93
  1598.     *   Added super 16 color palette selection for viewing in 16 colors.
  1599.         Pictures are not dithered, but look better than some dithered pics.
  1600.  
  1601.     VPIC ver 6.0b  1-30-93
  1602.     *   Added VESA ver 1.2 checking, so it recognizes hi-color modes.
  1603.     *   Added Alt M to menu to tell you what modes are currently defined.
  1604.     *   Added Alt C to menu to set the hi-color mode (8, 15, 16, or 24 bit).
  1605.     *   Fixed Alt S (from the keyboard) to rescan a drive after Alt F9.
  1606.     *   Fixed 'Abort, Retry, Fail' problem when you have additional floppy
  1607.         drives above drive C.
  1608.  
  1609.     VPIC ver 6.0c  2-09-93
  1610.     *   Fixed drives in directory tree so they can go from A to Z.
  1611.  
  1612.     VPIC ver 6.0d  3-02-93
  1613.     *   Added generic VESA configuration file, which you may modify to try to
  1614.         get a new board (which VPIC doesn't support directly) running. You may
  1615.         have to call the manufacturer to get some of the parameters.
  1616.  
  1617.     VPIC ver 6.0e  3-18-93
  1618.     *   Added provisions for more than 1 M video RAM.
  1619.     *   Added Realtek card with Sierra DAC (RELTEKHI).
  1620.  
  1621.     VPIC ver 6.0f  3-25-93
  1622.     *   Fixed a file reordering problem with Alt T from menu.
  1623.  
  1624.     VPIC ver 6.0g  5-19-93
  1625.     *   Added copy, move, and delete of tagged files, or single file at cursor
  1626.         if none are tagged. Changed the old Alt_C to Alt_F6 (view all color
  1627.         modes VPIC thinks you have) and old Alt_M to Alt_F7 (Lock hi-color mode).
  1628.         Alt_C now copies all tagged files to a different disk/directory, and
  1629.         Alt_M moves them to a different disk/directory. Alt_X now deletes all
  1630.         tagged files, but prompts you for each one. If not files are tagged, the
  1631.         single file at the cursor is copied, moved, or deleted.
  1632.  
  1633.     VPIC ver 6.1   8-10-93
  1634.     *   Fixed a minor bug in block delete.
  1635.     *    Finally added TIFF view/convert support, including LZW compressed TIFs.
  1636.     *   Added color reduction to 16 or 256 colors. Whew!
  1637.     *   Added Alt_S to menu to make a slidefile for the current marked files.
  1638.     *    Added conversion support for hi-color viewing, including mouse, menus
  1639.         and prompts. If you want to save a color reduced version of a hi-color
  1640.         picture, view it in 16 or 256 colors and then do the conversion.
  1641.     *   Added Slow Scan TV HRZ (18 bit/pixel) file format for viewing only.
  1642.  
  1643.     VPIC ver 6.1a  8-23-93
  1644.     *   Added 24 bit BMP viewing and conversion.
  1645.     *   Fixed minor TIF bug concerning CCITT (FAX) files.
  1646.  
  1647.     VPIC ver 6.1b  8-30-93
  1648.     *   Fixed a bug in the slideshow and Alt S (from the menu) to make a slide
  1649.         file.
  1650.     *   Added 'intelligent' resizing of the picture to the screen; keeps same
  1651.         aspect ratio so pictures aren't distorted. Use /g from the DOS command
  1652.         line to activate, or Alt G from the menu toggles on/off. Tab toggles
  1653.         between resized and normal.
  1654.  
  1655.     VPIC ver 6.1c  9-11-93
  1656.     *   Changed resize to integer, which reduced VPIC size by 15K.
  1657.     *   Fixed resize for slides (with screen locked with F7).
  1658.  
  1659.     VPIC ver 6.1d  9-22-93
  1660.     *   Major changes internally, with no apparent changes from 6.1c.
  1661.     *   Now handles resized multi-image GIFs.
  1662.  
  1663.     VPIC ver 6.1e 10-01-93
  1664.     *   Major revions internally. Much faster at displaying hi color files.
  1665.     *   You can now lock a mode and use resizing to get a slideshow which does
  1666.         not change video modes (which screws up VCR recordings).
  1667.     Subrev 1 - fixed a problems with certain Motorola format TIFs.
  1668.     Subrev 2 - fixed a problem decoding some GIFs.
  1669.     Subrev 3 - Added Ctrl_ENTER to view the picture at the cursor when other
  1670.         pictures are marked for slides, copying, etc.
  1671.     Subrev 4 - Add /rn to command line options-makes VPIC not write the picdata
  1672.         file to the current directory.
  1673.     Subrev 5 - Fixed a problem with certain Run Length Encoded TIF files.
  1674.     Subrev 6 - Fixed VPIC to handle incorrectly encoded PCX files.
  1675.     Subrev 7 - Added capability to do weather map type animation using the slide
  1676.         show. Command line /k or menu Alt K turns it on. The screen is not
  1677.         cleared between slides, and the 1st palette is used for all slides.
  1678.  
  1679.     VPIC ver 6.2 8-19-94
  1680.     Major revisions internally to accommodate dithering for color reduction.
  1681.     *   Increased files in menu to 10,000.
  1682.     *   Fixed a problem with LZW compressed TIF files using strips.
  1683.     *   Added dithering for color reduction. Makes 16 or 256 color pics look
  1684.         really good. Alt V toggles dithering on/off, and there is a ░ in the
  1685.         upper right corner to indicate when dithering will be used for color
  1686.         reduction. Dithering is not used for weathermap animation (for speed)
  1687.         and transparent color images in GIF89a files in 16 color mode.
  1688.     *   The maximum number of colors available for hi-color viewing at the
  1689.         current resolution is now shown in the middle of the top line in the
  1690.         menu. Alt F5/F6 are used to decrease/increase the locked hi-color
  1691.         mode (only if you have a hi-color card). The modes are 0=auto, 1=256,
  1692.         2=32K, 3=64K, 4=16 Million colors. Thus, even though your card will do
  1693.         24 bit (16 M colors) at 640x480, you can lock 32K colors to see how it
  1694.         looks at this color resolution, or 256 colors to color reduce so you can
  1695.         save it as a GIF, or any other 256 color file format (PCX, BMP, etc).
  1696.     *   Changed mode info from Alt F6 to part of Alt F3 (Settings), since F3 is
  1697.         picture info. Alt F7 still locks a hi-color mode. Alt F3 gives most
  1698.         settings for VPIC, and allows you to change them using the mouse or
  1699.         keyboard. Toggles are done by just clicking somewhere on the field, and
  1700.         things that require keyboard entry (margins and pathes) go to user entry
  1701.         mode when clicked. The Insert key toggles insert (large cursor) and
  1702.         overwrite (underline cursor) edit modes. For keyboard entry, Tab goes to
  1703.         next field, Shift Tab goes to previous field, and any key besides Enter
  1704.         or Esc toggles settings. Enter or Esc, or clicking on the first
  1705.         (Settings) line go back to the menu.
  1706.     *   Added environment variable VPICDISK to specify which disks VPIC should
  1707.         access; example: set vpicdisk=abce would allow VPIC to only look at
  1708.         drives a:, b:, c:, and e: with Alt F9. If environment variable absent,
  1709.         VPIC checks for all drives thru DOS by trying to read the current
  1710.         directory, which can slow startup if you have additional floppies.
  1711.     *   Added environment variable VPICSAVE to specify where VPIC should save
  1712.         all files that it creates; should include drive and directory.
  1713.     *   Added mode specifier from command line in addition to /mn. The new spec-
  1714.         ifier is /m:aaaxbbbxccc where aaa is the horizontal resolution, bbb is the
  1715.         vertical resolution, ccc is the number of colors (16, 256, 32K, 64K or
  1716.         16M), and x is the seperator (ie, /m:800x600x32K). If you don't have the
  1717.         mode specified, VPIC reverts to normal operation without the /m.
  1718.     *   Changed where VPIC saves files, and added checks for if the location is
  1719.         writeable. The location precedense is as follows:
  1720.         1. If /dt on command line, use current (this) directory if writeable.
  1721.            If /dp on command line use picture directory if writeable.
  1722.         2. If environment variable VPICSAVE exists, use location if writeable.
  1723.         3. Use picture directory if writeable.
  1724.         4. Use the current directory if writeable.
  1725.         5. Use C:\
  1726.         In general, if a drive is not writeable, VPIC goes to the next lower
  1727.         precedence. Thus, it will not try to write to CDs.
  1728.     *   Fixed problem with certain files while decoding if mouse was moved.
  1729.  
  1730.     Subrev 1 - 11-5-94 Improved the dithered color reduction.
  1731.     Subrev 2 - 11-15-94 Corrected a few bugs.
  1732.     Subrev 3 - 12-4-94 Corrected a GIF and PCX viewing bug.
  1733.     Subrev 4 - 12-6-94 Modified VPIC so would run with reduced memory.
  1734.     Subrev 5 - 12-7-94 Fixed a problem with 4 bit, 1 plane PCX's.
  1735.     Subrev 6 - 01-2-95 Registered copyright.
  1736.  
  1737.     VPIC ver 7.0  6-8-95
  1738.     *   Added JPEG capability. Added JPEG viewing, conversion, color reduction.
  1739.         J converts to JPG while viewing. Hint: If your video card supports
  1740.         hi-color modes, they are faster than color reducing to 256 colors. If
  1741.         your card does 800x600x32K or 64K colors, use one of these modes with
  1742.         'reduce to screen size (Alt G)' to view 1024x768 JPGs.
  1743.     *   Increased files in menu to 10,000 and no limit on tagged files. Tagging
  1744.         is from cursor on.
  1745.     *   Added a memory manager which uses Extended, Expanded, or Disk for
  1746.         virtual memory. Now you can view slide shows which snap on the screen
  1747.         of all all picture sizes. At least 2M of expanded memory, with EMM386 or
  1748.         the equivalent, speeds VPIC up tremendously, especially for quality
  1749.         color reduction of 24 bit JPGs. If you're running Windows, you can run
  1750.         VPIC's memory manager.
  1751.     *   /i minimizes the palette by eliminating redundant colors in palette so
  1752.         multiple images can add some more colors. Alt I toggles this switch from
  1753.         the menu.
  1754.     *   /q (for Quality) optimizes the palette for color reduction to 256
  1755.         colors. Normally VPIC uses a standard palette, and maps each hi-color
  1756.         pixel to the closest palette color (with dithering) to maximize speed.
  1757.         With the Q switch set, VPIC first goes thru the picture to make a
  1758.         histogram of the actual colors used, and then divides this into the best
  1759.         256 color palette. Then it goes thru the picture again and maps the
  1760.         actual pixel colors to the best palette color (with dithering). This
  1761.         takes more time, but gives a better quality picture. VPIC always uses
  1762.         /q for viewing hi-color pictures in 16 color modes, since there is no
  1763.         standard 16 color palette which looks good for all pictures. Alt Q
  1764.         toggles this switch from the menu.
  1765.     *   Added /snap to snap files onto screen instead of painting while
  1766.         decoding.
  1767.     *   Added for marked files in menu:
  1768.         1. ENTER/Alt_ENTER or Right/Left Arrows show next/previous picture.
  1769.         2. ESC or Alt Q quits back to menu.
  1770.         3. Spacebar tags current picture for further action back in menu.
  1771.         4. When back in menu, Alt U untags the pictures you just viewed, and
  1772.            tags any pictures for which you pressed Spacebar while viewing. You
  1773.            may then View (ENTER), Copy (Alt C), Move (Alt M), or Delete (Alt X)
  1774.            these files.
  1775.     *   Added /t command line switch to tag all files and show 1st. ENTER or
  1776.         RightArrow shows next, and Alt ENTER or LeftArrow shows previous. ESC or
  1777.         Alt Q quits to DOS. Spacebar does not tag files for further action while
  1778.         viewing in this mode.
  1779.     *   Added /single command line switch to do a slideshow (using vpic /@name)
  1780.         where:
  1781.         1. ENTER/Alt_ENTER or Right/Left Arrows show next/previous picture.
  1782.         2. ESC or Alt Q quits to DOS.
  1783.  
  1784.     VPIC ver 7.0a  7-2-95
  1785.     *   Fixed bug in 24 bit viewing.
  1786.     *   Fixed graphics menu/help.
  1787.     *   Changed default to not print filename; /z or Alt Z turns it on.
  1788.     *   Fixed problem with /t if directory didn't exist.
  1789.  
  1790.     VPIC ver 7.0b 7-5-95
  1791.     *   Fixed so could handle up to 5000 pixel wide JPG's.
  1792.     *   Fixed PCX conversion for hi color.
  1793.  
  1794.